Quellcode durchsuchen

Pico TCP Service Update

unknown vor 1 Monat
Ursprung
Commit
cb57ab50ce
137 geänderte Dateien mit 78048 neuen und 0 gelöschten Zeilen
  1. 1 0
      pico-tcp-service/pico-tcp-client/.gitignore
  2. 57 0
      pico-tcp-service/pico-tcp-client/.vscode/settings.json
  3. BIN
      pico-tcp-service/pico-tcp-client/Owin.dll
  4. BIN
      pico-tcp-service/pico-tcp-client/bin/Debug/pico-tcp-client.exe
  5. 254 0
      pico-tcp-service/pico-tcp-client/inc/HRDL.h
  6. 68 0
      pico-tcp-service/pico-tcp-client/inc/PicoCallback.h
  7. 271 0
      pico-tcp-service/pico-tcp-client/inc/PicoConnectProbes.h
  8. 46 0
      pico-tcp-service/pico-tcp-client/inc/PicoDeviceDefinitionsExperimental.h
  9. 356 0
      pico-tcp-service/pico-tcp-client/inc/PicoDeviceEnums.h
  10. 164 0
      pico-tcp-service/pico-tcp-client/inc/PicoDeviceStructs.h
  11. 1316 0
      pico-tcp-service/pico-tcp-client/inc/PicoStatus.h
  12. 37 0
      pico-tcp-service/pico-tcp-client/inc/PicoVersion.h
  13. 158 0
      pico-tcp-service/pico-tcp-client/inc/pl1000Api.h
  14. 168 0
      pico-tcp-service/pico-tcp-client/inc/plcm3Api.h
  15. 607 0
      pico-tcp-service/pico-tcp-client/inc/ps2000.h
  16. 2948 0
      pico-tcp-service/pico-tcp-client/inc/ps2000aApi.h
  17. 597 0
      pico-tcp-service/pico-tcp-client/inc/ps3000.h
  18. 1142 0
      pico-tcp-service/pico-tcp-client/inc/ps3000aApi.h
  19. 979 0
      pico-tcp-service/pico-tcp-client/inc/ps4000Api.h
  20. 1286 0
      pico-tcp-service/pico-tcp-client/inc/ps4000aApi.h
  21. 749 0
      pico-tcp-service/pico-tcp-client/inc/ps5000Api.h
  22. 1249 0
      pico-tcp-service/pico-tcp-client/inc/ps5000aApi.h
  23. 962 0
      pico-tcp-service/pico-tcp-client/inc/ps6000Api.h
  24. 765 0
      pico-tcp-service/pico-tcp-client/inc/ps6000aApi.h
  25. 116 0
      pico-tcp-service/pico-tcp-client/inc/ps6000aApiExperimental.h
  26. 364 0
      pico-tcp-service/pico-tcp-client/inc/usbDrDaqApi.h
  27. 181 0
      pico-tcp-service/pico-tcp-client/inc/usbPT104Api.h
  28. 387 0
      pico-tcp-service/pico-tcp-client/inc/usbtc08.h
  29. 1316 0
      pico-tcp-service/pico-tcp-client/libps4000a/PicoStatus.h
  30. 1286 0
      pico-tcp-service/pico-tcp-client/libps4000a/ps4000aApi.h
  31. 1153 0
      pico-tcp-service/pico-tcp-client/main.cpp
  32. BIN
      pico-tcp-service/pico-tcp-client/obj/Debug/main.o
  33. BIN
      pico-tcp-service/pico-tcp-client/obj/Debug/parser.o
  34. BIN
      pico-tcp-service/pico-tcp-client/obj/Debug/picofunctions.o
  35. BIN
      pico-tcp-service/pico-tcp-client/obj/Debug/pugixml.o
  36. BIN
      pico-tcp-service/pico-tcp-client/obj/Debug/src/ActiveSocket.o
  37. BIN
      pico-tcp-service/pico-tcp-client/obj/Debug/src/PassiveSocket.o
  38. BIN
      pico-tcp-service/pico-tcp-client/obj/Debug/src/SimpleSocket.o
  39. BIN
      pico-tcp-service/pico-tcp-client/obj/Debug/src/simplelogger.o
  40. 26 0
      pico-tcp-service/pico-tcp-client/parser.cpp
  41. 16 0
      pico-tcp-service/pico-tcp-client/parser.hpp
  42. BIN
      pico-tcp-service/pico-tcp-client/pico-tcp-client.exe
  43. 77 0
      pico-tcp-service/pico-tcp-client/pico-tcp.cbp
  44. 370 0
      pico-tcp-service/pico-tcp-client/pico-tcp.depend
  45. 30 0
      pico-tcp-service/pico-tcp-client/pico-tcp.layout
  46. BIN
      pico-tcp-service/pico-tcp-client/picocv.dll
  47. 340 0
      pico-tcp-service/pico-tcp-client/picofunctions.cpp
  48. 75 0
      pico-tcp-service/pico-tcp-client/picofunctions.h
  49. BIN
      pico-tcp-service/pico-tcp-client/picoipp.dll
  50. BIN
      pico-tcp-service/pico-tcp-client/ps4000a.dll
  51. BIN
      pico-tcp-service/pico-tcp-client/ps4000a.lib
  52. 77 0
      pico-tcp-service/pico-tcp-client/pugiconfig.hpp
  53. 13226 0
      pico-tcp-service/pico-tcp-client/pugixml.cpp
  54. 1516 0
      pico-tcp-service/pico-tcp-client/pugixml.hpp
  55. 371 0
      pico-tcp-service/pico-tcp-client/simplelogger.cpp
  56. 100 0
      pico-tcp-service/pico-tcp-client/simplelogger.hpp
  57. 310 0
      pico-tcp-service/pico-tcp-client/src/ActiveSocket.cpp
  58. 91 0
      pico-tcp-service/pico-tcp-client/src/ActiveSocket.h
  59. 263 0
      pico-tcp-service/pico-tcp-client/src/Host.h
  60. 328 0
      pico-tcp-service/pico-tcp-client/src/PassiveSocket.cpp
  61. 119 0
      pico-tcp-service/pico-tcp-client/src/PassiveSocket.h
  62. 1189 0
      pico-tcp-service/pico-tcp-client/src/SimpleSocket.cpp
  63. 584 0
      pico-tcp-service/pico-tcp-client/src/SimpleSocket.h
  64. 114 0
      pico-tcp-service/pico-tcp-client/src/StatTimer.h
  65. 466 0
      pico-tcp-service/pico-tcp-client/src/requests.cpp
  66. 23 0
      pico-tcp-service/pico-tcp-client/src/requests.h
  67. 336 0
      pico-tcp-service/pico-tcp-client/src/simplelogger.cpp
  68. 86 0
      pico-tcp-service/pico-tcp-client/src/simplelogger.hpp
  69. 1 0
      pico-tcp-service/pico-tcp/.gitignore
  70. 57 0
      pico-tcp-service/pico-tcp/.vscode/settings.json
  71. BIN
      pico-tcp-service/pico-tcp/Owin.dll
  72. BIN
      pico-tcp-service/pico-tcp/bin/Debug/pico-tcp.exe
  73. 254 0
      pico-tcp-service/pico-tcp/inc/HRDL.h
  74. 68 0
      pico-tcp-service/pico-tcp/inc/PicoCallback.h
  75. 271 0
      pico-tcp-service/pico-tcp/inc/PicoConnectProbes.h
  76. 46 0
      pico-tcp-service/pico-tcp/inc/PicoDeviceDefinitionsExperimental.h
  77. 356 0
      pico-tcp-service/pico-tcp/inc/PicoDeviceEnums.h
  78. 164 0
      pico-tcp-service/pico-tcp/inc/PicoDeviceStructs.h
  79. 1316 0
      pico-tcp-service/pico-tcp/inc/PicoStatus.h
  80. 37 0
      pico-tcp-service/pico-tcp/inc/PicoVersion.h
  81. 158 0
      pico-tcp-service/pico-tcp/inc/pl1000Api.h
  82. 168 0
      pico-tcp-service/pico-tcp/inc/plcm3Api.h
  83. 607 0
      pico-tcp-service/pico-tcp/inc/ps2000.h
  84. 2948 0
      pico-tcp-service/pico-tcp/inc/ps2000aApi.h
  85. 597 0
      pico-tcp-service/pico-tcp/inc/ps3000.h
  86. 1142 0
      pico-tcp-service/pico-tcp/inc/ps3000aApi.h
  87. 979 0
      pico-tcp-service/pico-tcp/inc/ps4000Api.h
  88. 1286 0
      pico-tcp-service/pico-tcp/inc/ps4000aApi.h
  89. 749 0
      pico-tcp-service/pico-tcp/inc/ps5000Api.h
  90. 1249 0
      pico-tcp-service/pico-tcp/inc/ps5000aApi.h
  91. 962 0
      pico-tcp-service/pico-tcp/inc/ps6000Api.h
  92. 765 0
      pico-tcp-service/pico-tcp/inc/ps6000aApi.h
  93. 116 0
      pico-tcp-service/pico-tcp/inc/ps6000aApiExperimental.h
  94. 364 0
      pico-tcp-service/pico-tcp/inc/usbDrDaqApi.h
  95. 181 0
      pico-tcp-service/pico-tcp/inc/usbPT104Api.h
  96. 387 0
      pico-tcp-service/pico-tcp/inc/usbtc08.h
  97. 1316 0
      pico-tcp-service/pico-tcp/libps4000a/PicoStatus.h
  98. 1286 0
      pico-tcp-service/pico-tcp/libps4000a/ps4000aApi.h
  99. 971 0
      pico-tcp-service/pico-tcp/main.cpp
  100. BIN
      pico-tcp-service/pico-tcp/obj/Debug/main.o
  101. BIN
      pico-tcp-service/pico-tcp/obj/Debug/parser.o
  102. BIN
      pico-tcp-service/pico-tcp/obj/Debug/picofunctions.o
  103. BIN
      pico-tcp-service/pico-tcp/obj/Debug/pugixml.o
  104. BIN
      pico-tcp-service/pico-tcp/obj/Debug/simplelogger.o
  105. BIN
      pico-tcp-service/pico-tcp/obj/Debug/src/ActiveSocket.o
  106. BIN
      pico-tcp-service/pico-tcp/obj/Debug/src/PassiveSocket.o
  107. BIN
      pico-tcp-service/pico-tcp/obj/Debug/src/SimpleSocket.o
  108. BIN
      pico-tcp-service/pico-tcp/obj/Debug/src/simplelogger.o
  109. 26 0
      pico-tcp-service/pico-tcp/parser.cpp
  110. 16 0
      pico-tcp-service/pico-tcp/parser.hpp
  111. 82 0
      pico-tcp-service/pico-tcp/pico-tcp.cbp
  112. 374 0
      pico-tcp-service/pico-tcp/pico-tcp.depend
  113. BIN
      pico-tcp-service/pico-tcp/pico-tcp.exe
  114. 20 0
      pico-tcp-service/pico-tcp/pico-tcp.layout
  115. BIN
      pico-tcp-service/pico-tcp/picocv.dll
  116. 340 0
      pico-tcp-service/pico-tcp/picofunctions.cpp
  117. 75 0
      pico-tcp-service/pico-tcp/picofunctions.h
  118. BIN
      pico-tcp-service/pico-tcp/picoipp.dll
  119. BIN
      pico-tcp-service/pico-tcp/ps4000a.dll
  120. BIN
      pico-tcp-service/pico-tcp/ps4000a.lib
  121. 77 0
      pico-tcp-service/pico-tcp/pugiconfig.hpp
  122. 13226 0
      pico-tcp-service/pico-tcp/pugixml.cpp
  123. 1516 0
      pico-tcp-service/pico-tcp/pugixml.hpp
  124. 371 0
      pico-tcp-service/pico-tcp/simplelogger.cpp
  125. 100 0
      pico-tcp-service/pico-tcp/simplelogger.hpp
  126. 310 0
      pico-tcp-service/pico-tcp/src/ActiveSocket.cpp
  127. 91 0
      pico-tcp-service/pico-tcp/src/ActiveSocket.h
  128. 263 0
      pico-tcp-service/pico-tcp/src/Host.h
  129. 328 0
      pico-tcp-service/pico-tcp/src/PassiveSocket.cpp
  130. 119 0
      pico-tcp-service/pico-tcp/src/PassiveSocket.h
  131. 1189 0
      pico-tcp-service/pico-tcp/src/SimpleSocket.cpp
  132. 584 0
      pico-tcp-service/pico-tcp/src/SimpleSocket.h
  133. 114 0
      pico-tcp-service/pico-tcp/src/StatTimer.h
  134. 466 0
      pico-tcp-service/pico-tcp/src/requests.cpp
  135. 23 0
      pico-tcp-service/pico-tcp/src/requests.h
  136. 335 0
      pico-tcp-service/pico-tcp/src/simplelogger.cpp
  137. 86 0
      pico-tcp-service/pico-tcp/src/simplelogger.hpp

+ 1 - 0
pico-tcp-service/pico-tcp-client/.gitignore

@@ -0,0 +1 @@
+.qodo

+ 57 - 0
pico-tcp-service/pico-tcp-client/.vscode/settings.json

@@ -0,0 +1,57 @@
+{
+    "files.associations": {
+        "tuple": "cpp",
+        "utility": "cpp",
+        "algorithm": "cpp",
+        "xstring": "cpp",
+        "ostream": "cpp",
+        "ios": "cpp",
+        "vector": "cpp",
+        "xutility": "cpp",
+        "atomic": "cpp",
+        "bitset": "cpp",
+        "cctype": "cpp",
+        "chrono": "cpp",
+        "cmath": "cpp",
+        "compare": "cpp",
+        "concepts": "cpp",
+        "cstddef": "cpp",
+        "cstdint": "cpp",
+        "cstdio": "cpp",
+        "cstdlib": "cpp",
+        "cstring": "cpp",
+        "ctime": "cpp",
+        "cwchar": "cpp",
+        "exception": "cpp",
+        "fstream": "cpp",
+        "initializer_list": "cpp",
+        "iomanip": "cpp",
+        "iosfwd": "cpp",
+        "iostream": "cpp",
+        "istream": "cpp",
+        "iterator": "cpp",
+        "limits": "cpp",
+        "memory": "cpp",
+        "new": "cpp",
+        "ratio": "cpp",
+        "sstream": "cpp",
+        "stdexcept": "cpp",
+        "streambuf": "cpp",
+        "string": "cpp",
+        "system_error": "cpp",
+        "thread": "cpp",
+        "type_traits": "cpp",
+        "typeinfo": "cpp",
+        "xfacet": "cpp",
+        "xiosbase": "cpp",
+        "xlocale": "cpp",
+        "xlocinfo": "cpp",
+        "xlocmon": "cpp",
+        "xlocnum": "cpp",
+        "xloctime": "cpp",
+        "xmemory": "cpp",
+        "xstddef": "cpp",
+        "xtr1common": "cpp"
+    },
+    "C_Cpp.errorSquiggles": "disabled"
+}

BIN
pico-tcp-service/pico-tcp-client/Owin.dll


BIN
pico-tcp-service/pico-tcp-client/bin/Debug/pico-tcp-client.exe


+ 254 - 0
pico-tcp-service/pico-tcp-client/inc/HRDL.h

@@ -0,0 +1,254 @@
+/****************************************************************************
+*
+* Filename:    HRDL.h
+* Author:			 MAS
+* Description:
+*
+* This header defines the interface to driver routines for the PicoLog
+*	High Resolution Data Logger Series.
+*
+* Copyright © 2004-2018 Pico Technology Ltd. All rights reserved.
+*
+****************************************************************************/
+#pragma once
+
+#include <stdint.h>
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+	#define TYPE_ENUM enum
+#endif
+
+#ifdef WIN32
+	//	If you are dynamically linking hrdl.dll into your project #define DYNLINK
+	//  somewhere in your project before here.
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (__stdcall *x)
+	#else
+		#define PREF1
+		#ifdef _USRDLL
+			#define PREF2 __declspec(dllexport) __stdcall
+		#else
+			#define PREF2 __declspec(dllimport) __stdcall
+		#endif
+		#define PREF3(x) x
+	#endif
+#else
+	/* Define a 64-bit integer type */
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+  #define __stdcall
+#endif
+
+#define HRDL_MAX_PICO_UNITS 64
+#define HRDL_MAX_UNITS 20
+
+typedef enum enHRDLInputs
+{
+  HRDL_DIGITAL_CHANNELS,
+  HRDL_ANALOG_IN_CHANNEL_1,
+  HRDL_ANALOG_IN_CHANNEL_2,
+  HRDL_ANALOG_IN_CHANNEL_3,
+  HRDL_ANALOG_IN_CHANNEL_4,
+  HRDL_ANALOG_IN_CHANNEL_5,
+  HRDL_ANALOG_IN_CHANNEL_6,
+  HRDL_ANALOG_IN_CHANNEL_7,
+  HRDL_ANALOG_IN_CHANNEL_8,
+  HRDL_ANALOG_IN_CHANNEL_9,
+  HRDL_ANALOG_IN_CHANNEL_10,
+  HRDL_ANALOG_IN_CHANNEL_11,
+  HRDL_ANALOG_IN_CHANNEL_12,
+  HRDL_ANALOG_IN_CHANNEL_13,
+  HRDL_ANALOG_IN_CHANNEL_14,
+  HRDL_ANALOG_IN_CHANNEL_15,
+  HRDL_ANALOG_IN_CHANNEL_16,
+  HRDL_MAX_ANALOG_CHANNELS = HRDL_ANALOG_IN_CHANNEL_16,
+} HRDL_INPUTS;
+
+typedef enum enHRDLDigitalIoChannel
+{   
+  HRDL_DIGITAL_IO_CHANNEL_1 = 0x01,
+  HRDL_DIGITAL_IO_CHANNEL_2 = 0x02,
+  HRDL_DIGITAL_IO_CHANNEL_3 = 0x04,
+  HRDL_DIGITAL_IO_CHANNEL_4 = 0x08,
+  HRDL_MAX_DIGITAL_CHANNELS = 4
+} HRDL_DIGITAL_IO_CHANNEL;
+
+typedef enum enHRDLRange
+{
+  HRDL_2500_MV,
+  HRDL_1250_MV,
+  HRDL_625_MV,
+  HRDL_313_MV,
+  HRDL_156_MV,
+  HRDL_78_MV,
+  HRDL_39_MV,  
+  HRDL_MAX_RANGES
+}	HRDL_RANGE;
+
+typedef enum enHRDLConversionTime
+{
+  HRDL_60MS,
+  HRDL_100MS,
+  HRDL_180MS,
+  HRDL_340MS,
+  HRDL_660MS,
+  HRDL_MAX_CONVERSION_TIMES
+
+}	HRDL_CONVERSION_TIME;
+
+typedef enum enHRDLInfo
+{
+  HRDL_DRIVER_VERSION,
+  HRDL_USB_VERSION,
+  HRDL_HARDWARE_VERSION,
+  HRDL_VARIANT_INFO,
+  HRDL_BATCH_AND_SERIAL,
+  HRDL_CAL_DATE,	
+  HRDL_KERNEL_DRIVER_VERSION, 
+  HRDL_ERROR,
+	HRDL_SETTINGS,
+} HRDL_INFO;
+
+typedef enum enHRDLErrorCode
+{
+	HRDL_OK,
+	HRDL_KERNEL_DRIVER,
+	HRDL_NOT_FOUND,
+	HRDL_CONFIG_FAIL,
+	HRDL_ERROR_OS_NOT_SUPPORTED,
+	HRDL_MAX_DEVICES
+} HRDL_ERROR_CODES;
+
+
+typedef enum enSettingsError
+{
+	SE_CONVERSION_TIME_OUT_OF_RANGE,
+	SE_SAMPLEINTERVAL_OUT_OF_RANGE,
+	SE_CONVERSION_TIME_TOO_SLOW,
+	SE_CHANNEL_NOT_AVAILABLE,
+	SE_INVALID_CHANNEL,
+	SE_INVALID_VOLTAGE_RANGE,
+	SE_INVALID_PARAMETER,
+	SE_CONVERSION_IN_PROGRESS,
+	SE_COMMUNICATION_FAILED,
+	SE_OK,
+	SE_MAX = SE_OK
+} SettingsError;
+
+typedef enum enHRDLOpenProgress
+{
+  HRDL_OPEN_PROGRESS_FAIL     = -1,
+  HRDL_OPEN_PROGRESS_PENDING  = 0,
+  HRDL_OPEN_PROGRESS_COMPLETE = 1
+} HRDL_OPEN_PROGRESS;
+
+typedef enum enBlockMethod
+{
+  HRDL_BM_BLOCK,
+  HRDL_BM_WINDOW,
+  HRDL_BM_STREAM
+} HRDL_BLOCK_METHOD;
+
+
+#define INVALID_HRDL_VALUE 0xF0000000
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLOpenUnit)	 ( void );
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLOpenUnitAsync) (void);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLOpenUnitProgress) (int16_t * handle, int16_t * progress);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLGetUnitInfo) (
+															int16_t handle,
+															int8_t * string,
+															int16_t stringLength,
+															int16_t info);
+
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLCloseUnit) ( int16_t handle );
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLGetMinMaxAdcCounts)(int16_t handle, int32_t * minAdc, int32_t * maxAdc, int16_t channel);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLSetAnalogInChannel) (int16_t handle, int16_t channel, int16_t enabled, int16_t	range, int16_t singleEnded);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLSetDigitalIOChannel) (int16_t handle, int16_t directionOut, int16_t digitalOutPinState, int16_t enabledDigitalIn);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLSetInterval)(int16_t handle, int32_t sampleInterval_ms, int16_t conversionTime);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLRun) (int16_t handle, int32_t	nValues, int16_t	method);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLReady) (int16_t handle);
+
+PREF0 PREF1 void PREF2  PREF3(HRDLStop)(int16_t handle);
+
+PREF0 PREF1 int32_t PREF2 PREF3(HRDLGetValues) (
+  int16_t handle,
+  int32_t * values,
+  int16_t * overflow,
+  int32_t no_of_values);
+
+PREF0 PREF1 int32_t PREF2 PREF3(HRDLGetTimesAndValues) (
+  int16_t handle,
+  int32_t  * times,
+  int32_t * values,
+  int16_t * overflow,
+  int32_t noOfValues);
+
+
+// this routine blocks other functions until it returns
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLGetSingleValue) (
+  int16_t handle,
+  int16_t channel,
+	int16_t	range,
+	int16_t conversionTime,
+	int16_t singleEnded,
+	int16_t *overflow,
+	int32_t *value); 
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLCollectSingleValueAsync) (
+  int16_t handle,
+  int16_t channel,
+	int16_t	range,
+	int16_t conversionTime,
+	int16_t singleEnded
+	); 
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLGetSingleValueAsync) (
+  int16_t handle,
+	int32_t *value,
+	int16_t *overflow); 
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLSetMains)(int16_t handle, int16_t sixtyHertz);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLGetNumberOfEnabledChannels)(int16_t handle, int16_t * nEnabledChannels);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (HRDLAcknowledge)(int16_t handle);

+ 68 - 0
pico-tcp-service/pico-tcp-client/inc/PicoCallback.h

@@ -0,0 +1,68 @@
+/****************************************************************************
+ *
+ * Filename:    PicoCallback.h
+ * Copyright:   Pico Technology Limited 2018 - 2022
+ * Description:
+ *
+ * This header contains definitions of various call back signatures used by
+ * the Picoscope drivers to asynchronously communicate.
+ *
+ ****************************************************************************/
+
+#ifndef __PICOCALLBACK_H__
+#define __PICOCALLBACK_H__
+
+#include <stdint.h>
+
+#include "PicoDeviceEnums.h"
+#include "PicoDeviceStructs.h"
+
+#ifdef WIN32
+#define PREF5 __stdcall
+#else
+#define PREF5
+#endif
+
+typedef void (PREF5 * PicoUpdateFirmwareProgress)
+(
+	int16_t        handle,
+	uint16_t			 progress
+	);
+
+typedef void (PREF5 *PicoProbeInteractions)
+(
+  int16_t    											handle,
+  PICO_STATUS											status,
+  PICO_USER_PROBE_INTERACTIONS *	probes,
+  uint32_t												nProbes
+);
+
+typedef void (PREF5 *PicoDataReadyUsingReads)
+(
+  int16_t    					handle,
+  PICO_READ_SELECTION read,
+  PICO_STATUS					status,
+  uint64_t						fromSegmentIndex,
+  uint64_t						toSegmentIndex,
+  PICO_POINTER				pParameter
+  );
+
+typedef void (PREF5 *PicoExternalReferenceInteractions)
+(
+  int16_t    											handle,
+  PICO_STATUS											status,
+  PICO_CLOCK_REFERENCE            reference
+  );
+
+typedef void (PREF5 *PicoAWGOverrangeInteractions)
+(
+  int16_t    											handle,
+  PICO_STATUS											status
+  );
+
+typedef void (PREF5 *PicoTemperatureSensorInteractions)
+(
+  int16_t    											handle,
+  PICO_TEMPERATURE_REFERENCE      temperatureStatus
+  );
+#endif

+ 271 - 0
pico-tcp-service/pico-tcp-client/inc/PicoConnectProbes.h

@@ -0,0 +1,271 @@
+/****************************************************************************
+ *
+ * Filename:    PicoConnectProbes.h
+ * Copyright:   Pico Technology Limited 2016 - 2022
+ * Description:
+ *
+ * This header defines enumerations relating to PicoConnect (TM)
+ * probes and the corresponding voltage/current ranges.
+ *
+ ****************************************************************************/
+
+#ifndef __PICOCONNECTPROBES_H__
+#define __PICOCONNECTPROBES_H__
+
+#include <stdint.h>
+
+typedef int32_t PicoConnectProbe;
+
+typedef enum enPicoConnectProbe
+{
+  PICO_CONNECT_PROBE_NONE = 0,
+
+  PICO_CONNECT_PROBE_D9_BNC = 4000,
+  PICO_CONNECT_PROBE_D9_2X_BNC,
+  PICO_CONNECT_PROBE_DIFFERENTIAL,
+  PICO_CONNECT_PROBE_CURRENT_CLAMP_200_2KA,
+  PICO_CONNECT_PROBE_CURRENT_CLAMP_40A,
+  PICO_CONNECT_PROBE_CAT3_HV_1KV,
+  PICO_CONNECT_PROBE_CURRENT_CLAMP_2000ARMS,
+
+  PICO_BNC_PLUS_PREMIUM_TEST_LEAD_BLUE = 4404,
+  PICO_BNC_PLUS_PREMIUM_TEST_LEAD_RED,
+  PICO_BNC_PLUS_PREMIUM_TEST_LEAD_GREEN,
+  PICO_BNC_PLUS_PREMIUM_TEST_LEAD_YELLOW,
+  PICO_BNC_PLUS_COP_PROBE,
+
+  PICO_BNC_PLUS_TEMPERATURE_PROBE = 5000,
+  PICO_BNC_PLUS_100A_CURRENT_CLAMP = 5003,
+  PICO_BNC_PLUS_HT_PICKUP = 5005,
+  PICO_BNC_PLUS_X10_SCOPE_PROBE = 5006,
+  PICO_BNC_PLUS_2000A_CURRENT_CLAMP = 5007,
+  PICO_BNC_PLUS_PRESSURE_SENSOR = 5008,
+  PICO_BNC_PLUS_RESISTANCE_LEAD = 5009,
+  PICO_BNC_PLUS_60A_CURRENT_CLAMP = 5010,
+  PICO_BNC_PLUS_OPTICAL_SENSOR = 5011,
+  PICO_BNC_PLUS_60A_CURRENT_CLAMP_V2 = 5012,
+  PICO_BNC_PLUS_HIGH_VOLTAGE_DIFFERENTIAL = 5013,
+
+  PICO_PASSIVE_PROBE_X10 = 6000,
+  PICO_ACTIVE_X10_750MHZ = 6001,
+  PICO_ACTIVE_X10_1_3GHZ = 6002,
+
+  PICO_CONNECT_PROBE_INTELLIGENT = -3,
+
+  PICO_CONNECT_PROBE_UNKNOWN_PROBE = -2,
+  PICO_CONNECT_PROBE_FAULT_PROBE = -1
+} PICO_CONNECT_PROBE;
+
+typedef enum enPicoConnectProbeRange
+{
+  PICO_X1_PROBE_10MV,
+  PICO_X1_PROBE_20MV,
+  PICO_X1_PROBE_50MV,
+  PICO_X1_PROBE_100MV,
+  PICO_X1_PROBE_200MV,
+  PICO_X1_PROBE_500MV,
+  PICO_X1_PROBE_1V,
+  PICO_X1_PROBE_2V,
+  PICO_X1_PROBE_5V,
+  PICO_X1_PROBE_10V,
+  PICO_X1_PROBE_20V,
+  PICO_X1_PROBE_50V,
+  PICO_X1_PROBE_100V,
+  PICO_X1_PROBE_200V,
+  PICO_X1_PROBE_RANGES = (PICO_X1_PROBE_200V + 1) - PICO_X1_PROBE_10MV,
+
+  PICO_X10_PROBE_100MV = 0x00000020,
+  PICO_X10_PROBE_200MV,
+  PICO_X10_PROBE_500MV,
+  PICO_X10_PROBE_1V,
+  PICO_X10_PROBE_2V,
+  PICO_X10_PROBE_5V,
+  PICO_X10_PROBE_10V,
+  PICO_X10_PROBE_20V,
+  PICO_X10_PROBE_50V,
+  PICO_X10_PROBE_100V,
+  PICO_X10_PROBE_200V,
+  PICO_X10_PROBE_500V,
+  PICO_X10_PROBE_RANGES = PICO_X10_PROBE_500V - PICO_X10_PROBE_100MV + 1,
+
+  PICO_PS4000A_RESISTANCE_315K = 0x00000200,
+  PICO_PS4000A_RESISTANCE_1100K,
+  PICO_PS4000A_RESISTANCE_10M,
+  PICO_PS4000A_MAX_RESISTANCE_RANGES = (PICO_PS4000A_RESISTANCE_10M + 1) - PICO_PS4000A_RESISTANCE_315K,
+  PICO_PS4000A_RESISTANCE_ADCV_FLAG = 0x10000000,
+
+  PICO_CONNECT_PROBE_OFF = 1024,
+
+  PICO_D9_BNC_10MV = 0,
+  PICO_D9_BNC_20MV,
+  PICO_D9_BNC_50MV,
+  PICO_D9_BNC_100MV,
+  PICO_D9_BNC_200MV,
+  PICO_D9_BNC_500MV,
+  PICO_D9_BNC_1V,
+  PICO_D9_BNC_2V,
+  PICO_D9_BNC_5V,
+  PICO_D9_BNC_10V,
+  PICO_D9_BNC_20V,
+  PICO_D9_BNC_50V,
+  PICO_D9_BNC_100V,
+  PICO_D9_BNC_200V,
+  PICO_MAX_D9_BNC_RANGES = (PICO_D9_BNC_200V + 1) - PICO_D9_BNC_10MV,
+
+
+  PICO_D9_2X_BNC_10MV = PICO_D9_BNC_10MV,
+  PICO_D9_2X_BNC_20MV = PICO_D9_BNC_20MV,
+  PICO_D9_2X_BNC_50MV = PICO_D9_BNC_50MV,
+  PICO_D9_2X_BNC_100MV = PICO_D9_BNC_100MV,
+  PICO_D9_2X_BNC_200MV = PICO_D9_BNC_200MV,
+  PICO_D9_2X_BNC_500MV = PICO_D9_BNC_500MV,
+  PICO_D9_2X_BNC_1V = PICO_D9_BNC_1V,
+  PICO_D9_2X_BNC_2V = PICO_D9_BNC_2V,
+  PICO_D9_2X_BNC_5V = PICO_D9_BNC_5V,
+  PICO_D9_2X_BNC_10V = PICO_D9_BNC_10V,
+  PICO_D9_2X_BNC_20V = PICO_D9_BNC_20V,
+  PICO_D9_2X_BNC_50V = PICO_D9_BNC_50V,
+  PICO_D9_2X_BNC_100V = PICO_D9_BNC_100V,
+  PICO_D9_2X_BNC_200V = PICO_D9_BNC_200V,
+  PICO_MAX_D9_2X_BNC_RANGES = (PICO_D9_2X_BNC_200V + 1) - PICO_D9_2X_BNC_10MV,
+
+
+  PICO_DIFFERENTIAL_10MV = PICO_D9_BNC_10MV,
+  PICO_DIFFERENTIAL_20MV = PICO_D9_BNC_20MV,
+  PICO_DIFFERENTIAL_50MV = PICO_D9_BNC_50MV,
+  PICO_DIFFERENTIAL_100MV = PICO_D9_BNC_100MV,
+  PICO_DIFFERENTIAL_200MV = PICO_D9_BNC_200MV,
+  PICO_DIFFERENTIAL_500MV = PICO_D9_BNC_500MV,
+  PICO_DIFFERENTIAL_1V = PICO_D9_BNC_1V,
+  PICO_DIFFERENTIAL_2V = PICO_D9_BNC_2V,
+  PICO_DIFFERENTIAL_5V = PICO_D9_BNC_5V,
+  PICO_DIFFERENTIAL_10V = PICO_D9_BNC_10V,
+  PICO_DIFFERENTIAL_20V = PICO_D9_BNC_20V,
+  PICO_DIFFERENTIAL_50V = PICO_D9_BNC_50V,
+  PICO_DIFFERENTIAL_100V = PICO_D9_BNC_100V,
+  PICO_DIFFERENTIAL_200V = PICO_D9_BNC_200V,
+  PICO_MAX_DIFFERENTIAL_RANGES = (PICO_DIFFERENTIAL_200V + 1) - PICO_DIFFERENTIAL_10MV,
+
+
+  PICO_CURRENT_CLAMP_200A_2kA_1A = 4000,
+  PICO_CURRENT_CLAMP_200A_2kA_2A,
+  PICO_CURRENT_CLAMP_200A_2kA_5A,
+  PICO_CURRENT_CLAMP_200A_2kA_10A,
+  PICO_CURRENT_CLAMP_200A_2kA_20A,
+  PICO_CURRENT_CLAMP_200A_2kA_50A,
+  PICO_CURRENT_CLAMP_200A_2kA_100A,
+  PICO_CURRENT_CLAMP_200A_2kA_200A,
+  PICO_CURRENT_CLAMP_200A_2kA_500A,
+  PICO_CURRENT_CLAMP_200A_2kA_1000A,
+  PICO_CURRENT_CLAMP_200A_2kA_2000A,
+  PICO_MAX_CURRENT_CLAMP_200A_2kA_RANGES = (PICO_CURRENT_CLAMP_200A_2kA_2000A + 1) - PICO_CURRENT_CLAMP_200A_2kA_1A,
+
+
+  PICO_CURRENT_CLAMP_40A_100mA = 5000,
+  PICO_CURRENT_CLAMP_40A_200mA,
+  PICO_CURRENT_CLAMP_40A_500mA,
+  PICO_CURRENT_CLAMP_40A_1A,
+  PICO_CURRENT_CLAMP_40A_2A,
+  PICO_CURRENT_CLAMP_40A_5A,
+  PICO_CURRENT_CLAMP_40A_10A,
+  PICO_CURRENT_CLAMP_40A_20A,
+  PICO_CURRENT_CLAMP_40A_40A,
+  PICO_MAX_CURRENT_CLAMP_40A_RANGES = (PICO_CURRENT_CLAMP_40A_40A + 1) - PICO_CURRENT_CLAMP_40A_100mA,
+
+  PICO_1KV_2_5V = 6003,
+  PICO_1KV_5V,
+  PICO_1KV_12_5V,
+  PICO_1KV_25V,
+  PICO_1KV_50V,
+  PICO_1KV_125V,
+  PICO_1KV_250V,
+  PICO_1KV_500V,
+  PICO_1KV_1000V,
+  PICO_MAX_1KV_RANGES = (PICO_1KV_1000V + 1) - PICO_1KV_2_5V,
+
+  PICO_CURRENT_CLAMP_2000ARMS_10A = 6500,
+  PICO_CURRENT_CLAMP_2000ARMS_20A,
+  PICO_CURRENT_CLAMP_2000ARMS_50A,
+  PICO_CURRENT_CLAMP_2000ARMS_100A,
+  PICO_CURRENT_CLAMP_2000ARMS_200A,
+  PICO_CURRENT_CLAMP_2000ARMS_500A,
+  PICO_CURRENT_CLAMP_2000ARMS_1000A,
+  PICO_CURRENT_CLAMP_2000ARMS_2000A,
+  PICO_CURRENT_CLAMP_2000ARMS_5000A,
+  PICO_CURRENT_CLAMP_2000ARMS_RANGES = (PICO_CURRENT_CLAMP_2000ARMS_5000A + 1) - PICO_CURRENT_CLAMP_2000ARMS_10A,
+
+  PICO_RESISTANCE_LEAD_NEG5_TO_20OHM = 7000,
+  PICO_RESISTANCE_LEAD_NEG50_TO_200OHM,
+  PICO_RESISTANCE_LEAD_NEG500_TO_2KOHM,
+  PICO_RESISTANCE_LEAD_NEG5K_TO_20KOHM,
+  PICO_RESISTANCE_LEAD_NEG50K_TO_LEAD_200KOHM,
+  PICO_RESISTANCE_LEAD_NEG500K_TO_LEAD_2MOHM,
+  PICO_RESISTANCE_LEAD_DIODE_TEST,
+  PICO_MAX_RESISTANCE_LEAD_RANGES = (PICO_RESISTANCE_LEAD_DIODE_TEST + 1) - PICO_RESISTANCE_LEAD_NEG50_TO_200OHM,
+
+  PICO_HT_NEG3_TO_5KV = 8950,
+  PICO_HT_NEG3_TO_10KV,
+  PICO_HT_NEG5_TO_20KV,
+  PICO_HT_NEG5_TO_50KV,
+  PICO_HT_NEG5_TO_100KV,
+  PICO_HT_NEG3_TO_5KV_INVERTED,
+  PICO_HT_NEG3_TO_10KV_INVERTED,
+  PICO_HT_NEG5_TO_20KV_INVERTED,
+  PICO_HT_NEG5_TO_50KV_INVERTED,
+  PICO_HT_NEG5_TO_100KV_INVERTED,
+  PICO_MAX_HT_RANGES = PICO_HT_NEG5_TO_100KV_INVERTED - PICO_HT_NEG3_TO_5KV + 1,
+
+  PICO_TEMPERATURE_NEG50_TO_150DEGC = 9000,
+
+  PICO_PRESSURE_SENSOR_NEG100000_TO_150000_PASCALS = 9100,
+  PICO_PRESSURE_SENSOR_NEG100000_TO_400000_PASCALS = 9101,
+  PICO_PRESSURE_SENSOR_NEG200000_TO_800000_PASCALS = 9102,
+  PICO_PRESSURE_SENSOR_NEG400000_TO_1600000_PASCALS = 9103,
+  PICO_PRESSURE_SENSOR_NEG400000_TO_3400000_PASCALS = 9104,
+  PICO_PRESSURE_SENSOR_NEG150000_TO_1350000_PASCALS = 9105,
+
+  PICO_CURRENT_CLAMP_100A_2_5A = 10000,
+  PICO_CURRENT_CLAMP_100A_5A,
+  PICO_CURRENT_CLAMP_100A_10A,
+  PICO_CURRENT_CLAMP_100A_25A,
+  PICO_CURRENT_CLAMP_100A_50A,
+  PICO_CURRENT_CLAMP_100A_100A,
+
+  PICO_CURRENT_CLAMP_60A_2A = 10500,
+  PICO_CURRENT_CLAMP_60A_5A,
+  PICO_CURRENT_CLAMP_60A_10A,
+  PICO_CURRENT_CLAMP_60A_20A,
+  PICO_CURRENT_CLAMP_60A_50A,
+  PICO_CURRENT_CLAMP_60A_60A,
+
+  PICO_OPTICAL_SENSOR_10V = 10550,
+
+  PICO_CURRENT_CLAMP_60A_V2_0_5A = 10600,
+  PICO_CURRENT_CLAMP_60A_V2_1A,
+  PICO_CURRENT_CLAMP_60A_V2_2A,
+  PICO_CURRENT_CLAMP_60A_V2_5A,
+  PICO_CURRENT_CLAMP_60A_V2_10A,
+  PICO_CURRENT_CLAMP_60A_V2_20A,
+  PICO_CURRENT_CLAMP_60A_V2_50A,
+  PICO_CURRENT_CLAMP_60A_V2_60A,
+
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_5V = 10650,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_10V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_20V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_50V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_100V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_200V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_500V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_1000V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_1400V,
+
+  PICO_X10_ACTIVE_PROBE_100MV = 10700,
+  PICO_X10_ACTIVE_PROBE_200MV,
+  PICO_X10_ACTIVE_PROBE_500MV,
+  PICO_X10_ACTIVE_PROBE_1V,
+  PICO_X10_ACTIVE_PROBE_2V,
+  PICO_X10_ACTIVE_PROBE_5V,
+
+} PICO_CONNECT_PROBE_RANGE;
+
+#endif

+ 46 - 0
pico-tcp-service/pico-tcp-client/inc/PicoDeviceDefinitionsExperimental.h

@@ -0,0 +1,46 @@
+/****************************************************************************
+ *
+ * Filename:    PicoDeviceDefinitionsExperimental.h
+ * Copyright:   Pico Technology Limited 2016 - 2022
+ * Description:
+ *
+ * This header contains definitions of enumerated types and structs which
+ * are at the beta stage of development and their signatures may change.
+ ****************************************************************************/
+
+#ifndef __PICODEVICEDEFINITIONSEXPERIMENTAL_H__
+#define __PICODEVICEDEFINITIONSEXPERIMENTAL_H__
+
+#include <stdint.h>
+
+/// <summary>
+/// Probe user action (only button press events supported for now). Other event types
+/// may be added in future to support new probes.
+/// </summary>
+typedef enum enPicoProbeUserAction
+{
+  PICO_PROBE_BUTTON_PRESS, /// parameter struct -> PICO_PROBE_BUTTON_PRESS_PARAMETER
+} PICO_PROBE_USER_ACTION;
+
+/// <summary>
+/// The duration of the button press event.
+/// </summary>
+typedef enum enPicoProbeButtonPressType
+{
+  PICO_PROBE_BUTTON_SHORT_DURATION_PRESS,
+  PICO_PROBE_BUTTON_LONG_DURATION_PRESS,
+} PICO_PROBE_BUTTON_PRESS_TYPE;
+
+#pragma pack(push, 1)
+/// <summary>
+/// The parameter struct for a button press event, indicating which button was
+/// pressed (in case future probes have multiple) and the type of press.
+/// </summary>
+typedef struct tPicoProbeButtonPressParameter
+{
+  uint8_t buttonIndex;
+  PICO_PROBE_BUTTON_PRESS_TYPE buttonPressType;
+} PICO_PROBE_BUTTON_PRESS_PARAMETER;
+#pragma pack(pop)
+
+#endif

+ 356 - 0
pico-tcp-service/pico-tcp-client/inc/PicoDeviceEnums.h

@@ -0,0 +1,356 @@
+/****************************************************************************
+ *
+ * Filename:    PicoDeviceEnums.h
+ * Copyright:   Pico Technology Limited 2016 - 2022
+ * Description:
+ *
+ * This header contains definitions of enumerated types that describe
+ * various operating modes, trigger types, bandwidth limiters, etc.
+ *
+ ****************************************************************************/
+
+#ifndef __PICODEVICEENUMS_H__
+#define __PICODEVICEENUMS_H__
+
+typedef enum enPicoRatioMode
+{
+  PICO_RATIO_MODE_AGGREGATE = 1,
+  PICO_RATIO_MODE_DECIMATE = 2,
+  PICO_RATIO_MODE_AVERAGE = 4,
+  PICO_RATIO_MODE_DISTRIBUTION = 8,
+  PICO_RATIO_MODE_SUM = 16,
+
+  PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION = 0x10000000, // buffers cannot be set for this mode
+  PICO_RATIO_MODE_SEGMENT_HEADER = 0x20000000, // buffers do not need to be set for this
+  PICO_RATIO_MODE_TRIGGER = 0x40000000, // this cannot be combined with any other ratio mode
+  PICO_RATIO_MODE_RAW = 0x80000000
+} PICO_RATIO_MODE;
+
+typedef enum enPicoChannel
+{
+  PICO_CHANNEL_A = 0,
+  PICO_CHANNEL_B = 1,
+  PICO_CHANNEL_C = 2,
+  PICO_CHANNEL_D = 3,
+  PICO_CHANNEL_E = 4,
+  PICO_CHANNEL_F = 5,
+  PICO_CHANNEL_G = 6,
+  PICO_CHANNEL_H = 7,
+
+  PICO_PORT0 = 128,
+  PICO_PORT1 = 129,
+  PICO_PORT2 = 130,
+  PICO_PORT3 = 131,
+
+  PICO_EXTERNAL = 1000,
+  PICO_TRIGGER_AUX = 1001,
+
+  PICO_PULSE_WIDTH_SOURCE = 0x10000000,
+  PICO_DIGITAL_SOURCE = 0x10000001
+} PICO_CHANNEL;
+
+typedef enum enPicoChannelFlags
+{
+  PICO_CHANNEL_A_FLAGS = 1,
+  PICO_CHANNEL_B_FLAGS = 2,
+  PICO_CHANNEL_C_FLAGS = 4,
+  PICO_CHANNEL_D_FLAGS = 8,
+  PICO_CHANNEL_E_FLAGS = 16,
+  PICO_CHANNEL_F_FLAGS = 32,
+  PICO_CHANNEL_G_FLAGS = 64,
+  PICO_CHANNEL_H_FLAGS = 128,
+
+  PICO_PORT0_FLAGS = 65536,
+  PICO_PORT1_FLAGS = 131072,
+  PICO_PORT2_FLAGS = 262144,
+  PICO_PORT3_FLAGS = 524288,
+
+} PICO_CHANNEL_FLAGS;
+
+typedef enum enPicoPortDigitalChannel
+{
+  PICO_PORT_DIGITAL_CHANNEL0,
+  PICO_PORT_DIGITAL_CHANNEL1,
+  PICO_PORT_DIGITAL_CHANNEL2,
+  PICO_PORT_DIGITAL_CHANNEL3,
+  PICO_PORT_DIGITAL_CHANNEL4,
+  PICO_PORT_DIGITAL_CHANNEL5,
+  PICO_PORT_DIGITAL_CHANNEL6,
+  PICO_PORT_DIGITAL_CHANNEL7
+} PICO_PORT_DIGITAL_CHANNEL;
+
+typedef enum enPicoDataType
+{
+  PICO_INT8_T,
+  PICO_INT16_T,
+  PICO_INT32_T,
+  PICO_UINT32_T,
+  PICO_INT64_T
+} PICO_DATA_TYPE;
+
+typedef enum enPicoCoupling
+{
+  PICO_AC = 0,
+  PICO_DC = 1,
+
+  PICO_DC_50OHM = 50
+} PICO_COUPLING;
+
+typedef enum enPicoBandwidthLimiterFlags
+{
+  PICO_BW_FULL_FLAG = (1 << 0),
+  PICO_BW_20KHZ_FLAG = (1 << 1),
+  PICO_BW_100KHZ_FLAG = (1 << 2), //( default when current clamp detected: can be changed)
+  PICO_BW_1MHZ_FLAG = (1 << 3), //( default for 14 bits: can be changed)
+  PICO_BW_20MHZ_FLAG = (1 << 4),
+  PICO_BW_200MHZ_FLAG = (1 << 5),
+} PICO_BANDWIDTH_LIMITER_FLAGS;
+
+typedef enum enPicoBandwidthLimiter
+{
+  PICO_BW_FULL = 0,
+
+  PICO_BW_100KHZ = 100000,
+
+  PICO_BW_20KHZ = 20000,
+
+  PICO_BW_1MHZ = 1000000,
+  PICO_BW_20MHZ = 20000000,
+
+  PICO_BW_25MHZ = 25000000,
+
+  PICO_BW_50MHZ = 50000000,
+
+  PICO_BW_200MHZ = 200000000,
+  PICO_BW_250MHZ = 250000000,
+
+  PICO_BW_500MHZ = 500000000,
+
+} PICO_BANDWIDTH_LIMITER;
+
+typedef enum enPicoPulseWidthType
+{
+  PICO_PW_TYPE_NONE = 0,
+  PICO_PW_TYPE_LESS_THAN = 1,
+  PICO_PW_TYPE_GREATER_THAN = 2,
+  PICO_PW_TYPE_IN_RANGE = 3,
+  PICO_PW_TYPE_OUT_OF_RANGE = 4
+} PICO_PULSE_WIDTH_TYPE;
+
+typedef enum enPicoSweepType
+{
+  PICO_UP = 0,
+  PICO_DOWN = 1,
+  PICO_UPDOWN = 2,
+  PICO_DOWNUP = 3,
+} PICO_SWEEP_TYPE;
+
+typedef enum enPicoWaveType
+{
+  PICO_SINE = 0x00000011,
+  PICO_SQUARE = 0x00000012,
+  PICO_TRIANGLE = 0x00000013,
+  PICO_RAMP_UP = 0x00000014,
+  PICO_RAMP_DOWN = 0x00000015,
+  PICO_SINC = 0x00000016,
+  PICO_GAUSSIAN = 0x00000017,
+  PICO_HALF_SINE = 0x00000018,
+
+  PICO_DC_VOLTAGE = 0x00000400,
+
+  PICO_PWM = 0x00001000,
+
+  PICO_WHITENOISE = 0x00002001,
+  PICO_PRBS = 0x00002002, // Pseudo-Random Bit Stream
+
+  PICO_ARBITRARY = 0x10000000
+} PICO_WAVE_TYPE;
+
+typedef enum enPicoSigGenTrigType
+{
+  PICO_SIGGEN_RISING = 0,
+  PICO_SIGGEN_FALLING = 1,
+  PICO_SIGGEN_GATE_HIGH = 2,
+  PICO_SIGGEN_GATE_LOW = 3
+} PICO_SIGGEN_TRIG_TYPE;
+
+typedef enum enPicoSigGenTrigSource
+{
+  PICO_SIGGEN_NONE = 0,
+  PICO_SIGGEN_SCOPE_TRIG = 1,
+  PICO_SIGGEN_AUX_IN = 2,
+  PICO_SIGGEN_EXT_IN = 3,
+  PICO_SIGGEN_SOFT_TRIG = 4,
+  PICO_SIGGEN_TRIGGER_RAW = 5
+} PICO_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPicoSigGenFilterState
+{
+  PICO_SIGGEN_FILTER_AUTO = 0,
+  PICO_SIGGEN_FILTER_OFF = 1,
+  PICO_SIGGEN_FILTER_ON = 2
+} PICO_SIGGEN_FILTER_STATE;
+
+typedef enum enPicoSigGenParameter
+{
+  PICO_SIGGEN_PARAM_OUTPUT_VOLTS = 0,
+  PICO_SIGGEN_PARAM_SAMPLE = 1,
+  PICO_SIGGEN_PARAM_BUFFER_LENGTH = 2
+} PICO_SIGGEN_PARAMETER;
+
+typedef enum enPicoTimeUnits
+{
+  PICO_FS = 0,
+  PICO_PS = 1,
+  PICO_NS = 2,
+  PICO_US = 3,
+  PICO_MS = 4,
+  PICO_S = 5,
+} PICO_TIME_UNITS;
+
+typedef enum enPicoThresholdDirection
+{
+  PICO_ABOVE = 0, //using upper threshold
+  PICO_BELOW = 1, //using upper threshold
+  PICO_RISING = 2, // using upper threshold
+  PICO_FALLING = 3, // using upper threshold
+  PICO_RISING_OR_FALLING = 4, // using both thresholds
+  PICO_ABOVE_LOWER = 5, // using lower threshold
+  PICO_BELOW_LOWER = 6, // using lower threshold
+  PICO_RISING_LOWER = 7, // using lower threshold
+  PICO_FALLING_LOWER = 8, // using lower threshold
+
+  // Windowing using both thresholds
+  PICO_INSIDE = PICO_ABOVE,
+  PICO_OUTSIDE = PICO_BELOW,
+  PICO_ENTER = PICO_RISING,
+  PICO_EXIT = PICO_FALLING,
+  PICO_ENTER_OR_EXIT = PICO_RISING_OR_FALLING,
+  PICO_POSITIVE_RUNT = 9,
+  PICO_NEGATIVE_RUNT,
+
+  // no trigger set
+  PICO_NONE = PICO_RISING
+} PICO_THRESHOLD_DIRECTION;
+
+typedef enum enPicoThresholdMode
+{
+  PICO_LEVEL = 0,
+  PICO_WINDOW = 1
+} PICO_THRESHOLD_MODE;
+
+typedef enum enPicoEtsMode
+{
+  PICO_ETS_OFF = 0, // ETS disabled
+  PICO_ETS_FAST = 1, // Return ready as soon as requested no of interleaves is available
+  PICO_ETS_SLOW = 2, // Return ready every time a new set of no_of_cycles is collected
+} PICO_ETS_MODE;
+
+typedef enum enPicoIndexMode
+{
+  PICO_SINGLE = 0,
+  PICO_DUAL = 1,
+  PICO_QUAD = 2,
+} PICO_INDEX_MODE;
+
+typedef enum enPicoAction
+{
+  PICO_CLEAR_ALL = 0x00000001,
+  PICO_ADD = 0x00000002,
+
+  PICO_CLEAR_THIS_DATA_BUFFER = 0x00001000,
+  PICO_CLEAR_WAVEFORM_DATA_BUFFERS = 0x00002000,
+  PICO_CLEAR_WAVEFORM_READ_DATA_BUFFERS = 0x00004000,
+
+} PICO_ACTION;
+
+typedef enum enPicoTriggerState
+{
+  PICO_CONDITION_DONT_CARE = 0,
+  PICO_CONDITION_TRUE = 1,
+  PICO_CONDITION_FALSE = 2,
+} PICO_TRIGGER_STATE;
+
+typedef enum enPicoDeviceResolution
+{
+  PICO_DR_8BIT = 0,
+  PICO_DR_12BIT = 1,
+  PICO_DR_14BIT = 2,
+  PICO_DR_15BIT = 3,
+  PICO_DR_16BIT = 4,
+
+  PICO_DR_10BIT = 10,
+
+} PICO_DEVICE_RESOLUTION;
+
+typedef enum enPicoReadSelection
+{
+  PICO_READSELECTION_NONE = 0,
+  PICO_TRIGGER_READ = 1,
+  PICO_DATA_READ1 = 2,
+  PICO_DATA_READ2 = 3,
+  PICO_DATA_READ3 = 4,
+} PICO_READ_SELECTION;
+
+typedef enum enPicoTrimAction
+{
+  PICO_OLDEST,
+  PICO_RECENT
+} PICO_TRIM_ACTION;
+
+typedef enum enPicoDigitalPortHysteresis
+{
+  PICO_VERY_HIGH_400MV,
+  PICO_HIGH_200MV,
+  PICO_NORMAL_100MV,
+  PICO_LOW_50MV
+} PICO_DIGITAL_PORT_HYSTERESIS;
+
+typedef enum enPicoDigitalDirection
+{
+  PICO_DIGITAL_DONT_CARE,
+  PICO_DIGITAL_DIRECTION_LOW,
+  PICO_DIGITAL_DIRECTION_HIGH,
+  PICO_DIGITAL_DIRECTION_RISING,
+  PICO_DIGITAL_DIRECTION_FALLING,
+  PICO_DIGITAL_DIRECTION_RISING_OR_FALLING,
+  PICO_DIGITAL_MAX_DIRECTION
+} PICO_DIGITAL_DIRECTION;
+
+typedef enum enPicoConditionsInfo
+{
+  PICO_CLEAR_CONDITIONS = 0x00000001,
+  PICO_ADD_CONDITION = 0x00000002
+} PICO_CONDITIONS_INFO;
+
+typedef enum enPicoClockReference
+{
+  PICO_INTERNAL_REF,
+  PICO_EXTERNAL_REF
+} PICO_CLOCK_REFERENCE;
+
+typedef enum enPicoTriggerWithinPreTrigger
+{
+  PICO_DISABLE,
+  PICO_ARM
+} PICO_TRIGGER_WITHIN_PRE_TRIGGER;
+
+typedef enum tPicoTemperatureReference
+{
+  PICO_TEMPERATURE_UNINITIALISED,
+  PICO_TEMPERATURE_NORMAL,
+  PICO_TEMPERATURE_WARNING,
+  PICO_TEMPERATURE_CRITICAL
+} PICO_TEMPERATURE_REFERENCE;
+
+typedef enum enPicoDigitalPort
+{
+  PICO_DIGITAL_PORT_NONE = 0,
+
+  PICO_DIGITAL_PORT_MSO_POD = 1000,
+
+  PICO_DIGITAL_PORT_UNKNOWN_DEVICE = -2,
+
+} PICO_DIGITAL_PORT;
+
+#endif

+ 164 - 0
pico-tcp-service/pico-tcp-client/inc/PicoDeviceStructs.h

@@ -0,0 +1,164 @@
+/****************************************************************************
+ *
+ * Filename:    PicoDeviceStructs.h
+ * Copyright:   Pico Technology Limited 2016 - 2022
+ * Description:
+ *
+ * This header defines structs used by various Picoscope driver API calls,
+ * defining how to pack/unpack bytes to communicate with a connected scope.
+ *
+ ****************************************************************************/
+
+#ifndef __PICODEVICESTRUCTS_H__
+#define __PICODEVICESTRUCTS_H__
+
+#define DIGITAL_PORT_SERIAL_LENGTH 10
+#define DIGITAL_PORT_CALIBRATION_DATE_LENGTH 8
+
+#include <stdint.h>
+
+#include "PicoConnectProbes.h"
+#include "PicoDeviceEnums.h"
+#include "PicoStatus.h"
+
+#pragma pack(push,1)
+typedef struct tPicoTriggerInfo
+{
+	PICO_STATUS	status;
+	uint64_t	segmentIndex;
+	uint64_t	triggerIndex;
+	double		triggerTime;
+	PICO_TIME_UNITS	timeUnits;
+	uint64_t	missedTriggers;
+	uint64_t	timeStampCounter;
+} PICO_TRIGGER_INFO;
+
+typedef struct tPicoTriggerChannelProperties
+{
+	int16_t								thresholdUpper;
+	uint16_t							thresholdUpperHysteresis;
+	int16_t								thresholdLower;
+	uint16_t							thresholdLowerHysteresis;
+	PICO_CHANNEL					channel;
+} PICO_TRIGGER_CHANNEL_PROPERTIES;
+
+typedef struct tPicoCondition
+{
+	PICO_CHANNEL   		source;
+	PICO_TRIGGER_STATE condition;
+} PICO_CONDITION;
+
+typedef struct tPicoDirection
+{
+	PICO_CHANNEL							channel;
+	PICO_THRESHOLD_DIRECTION	direction;
+	PICO_THRESHOLD_MODE				thresholdMode;
+} PICO_DIRECTION;
+
+typedef struct tPicoUserProbeInteractions
+{
+	uint16_t connected_;
+
+	PICO_CHANNEL channel_;
+	uint16_t enabled_;
+
+	PicoConnectProbe probeName_;
+
+	uint8_t requiresPower_;
+	uint8_t isPowered_;
+
+	PICO_STATUS status_;
+
+	PICO_CONNECT_PROBE_RANGE probeOff_;
+
+	PICO_CONNECT_PROBE_RANGE rangeFirst_;
+	PICO_CONNECT_PROBE_RANGE rangeLast_;
+	PICO_CONNECT_PROBE_RANGE rangeCurrent_;
+
+	PICO_COUPLING couplingFirst_;
+	PICO_COUPLING couplingLast_;
+	PICO_COUPLING couplingCurrent_;
+
+  PICO_BANDWIDTH_LIMITER_FLAGS filterFlags_;
+  PICO_BANDWIDTH_LIMITER_FLAGS filterCurrent_;
+	PICO_BANDWIDTH_LIMITER defaultFilter_;
+} PICO_USER_PROBE_INTERACTIONS;
+
+typedef struct tPicoDataBuffers
+{
+	PICO_CHANNEL							channel_;
+	uint64_t									waveform_;
+	PICO_RATIO_MODE						downSampleRatioMode_;
+	PICO_READ_SELECTION				read_;
+
+	PICO_POINTER							bufferMax_;
+	PICO_POINTER							bufferMin_;
+	PICO_DATA_TYPE						dataType_;
+
+	uint32_t									nDistributionPoints_;
+} PICO_DATA_BUFFERS;
+
+typedef struct tPicoStreamingDataInfo
+{
+	// in
+	PICO_CHANNEL channel_;
+	PICO_RATIO_MODE mode_;
+	PICO_DATA_TYPE type_;
+
+	int32_t		noOfSamples_;
+	uint64_t	bufferIndex_;
+	int32_t	startIndex_;
+	int16_t   overflow_;
+} PICO_STREAMING_DATA_INFO;
+
+typedef struct tPicoStreamingDataTriggerInfo
+{
+	uint64_t	triggerAt_;
+	int16_t   triggered_;
+	int16_t		autoStop_;
+} PICO_STREAMING_DATA_TRIGGER_INFO;
+
+typedef struct tPicoScalingFactors
+{
+	PICO_CHANNEL							channel;
+	PICO_CONNECT_PROBE_RANGE  range;
+	int16_t										offset;
+	double							      scalingFactor;
+} PICO_SCALING_FACTORS_VALUES;
+
+typedef struct tProbeApp
+{
+	int32_t                   id_;
+	int32_t                   appMajorVersion_;
+	int32_t                   appMinorVersion_;
+} PROBE_APP;
+
+typedef struct tDigitalChannelDirections
+{
+  PICO_PORT_DIGITAL_CHANNEL channel;
+	PICO_DIGITAL_DIRECTION direction;
+} PICO_DIGITAL_CHANNEL_DIRECTIONS;
+
+typedef struct tPicoDigitalPortInteractions
+{
+  uint16_t connected_;
+
+  PICO_CHANNEL channel_;
+
+  PICO_DIGITAL_PORT digitalPortName_;
+
+  PICO_STATUS status_;
+
+  int8_t serial_[DIGITAL_PORT_SERIAL_LENGTH];
+  int8_t calibrationDate_[DIGITAL_PORT_CALIBRATION_DATE_LENGTH];
+} PICO_DIGITAL_PORT_INTERACTIONS;
+
+typedef struct tPicoChannelOvervoltageTripped
+{
+  PICO_CHANNEL channel_;
+  uint8_t tripped_;
+} PICO_CHANNEL_OVERVOLTAGE_TRIPPED;
+
+#pragma pack(pop)
+
+#endif

+ 1316 - 0
pico-tcp-service/pico-tcp-client/inc/PicoStatus.h

@@ -0,0 +1,1316 @@
+/**************************************************************************
+*
+* Filename:    PicoStatus.h
+* Copyright:   Pico Technology Limited 2002 - 2022
+* Description:
+*
+* This header files defines the status codes returned by a
+*	Pico device, a PC Oscilloscope or Data Logger.
+*
+* In comments, "<API>" is a placeholder for the name of the scope or
+* data logger API. For example, for the ps5000a API, it stands for
+* "PS5000A" or "ps5000a".
+*
+*************************************************************************/
+#ifndef __PICOSTATUS_H__
+#define __PICOSTATUS_H__
+
+#include <stdint.h>
+
+typedef void * PICO_POINTER;
+
+#define	PICO_DRIVER_VERSION                         0x00000000UL
+#define	PICO_USB_VERSION                            0x00000001UL
+#define	PICO_HARDWARE_VERSION                       0x00000002UL
+#define	PICO_VARIANT_INFO                           0x00000003UL
+#define	PICO_BATCH_AND_SERIAL                       0x00000004UL
+#define	PICO_CAL_DATE                               0x00000005UL
+#define	PICO_KERNEL_VERSION                         0x00000006UL
+
+#define PICO_DIGITAL_HARDWARE_VERSION               0x00000007UL
+#define PICO_ANALOGUE_HARDWARE_VERSION              0x00000008UL
+
+#define PICO_FIRMWARE_VERSION_1                     0x00000009UL
+#define PICO_FIRMWARE_VERSION_2                     0x0000000AUL
+
+#define PICO_MAC_ADDRESS                            0x0000000BUL
+
+#define PICO_SHADOW_CAL                             0x0000000CUL
+
+#define PICO_IPP_VERSION                            0x0000000DUL
+
+#define PICO_DRIVER_PATH                            0x0000000EUL
+
+#define PICO_FIRMWARE_VERSION_3                     0x0000000FUL
+
+#define PICO_FRONT_PANEL_FIRMWARE_VERSION           0x00000010UL
+
+#define PICO_BOOTLOADER_VERSION						0x10000001UL
+
+typedef uint32_t PICO_INFO;
+
+// The PicoScope is functioning correctly.
+#define PICO_OK                                     0x00000000UL
+
+// An attempt has been made to open more than <API>_MAX_UNITS.
+#define PICO_MAX_UNITS_OPENED                       0x00000001UL
+
+// Not enough memory could be allocated on the host machine.
+#define PICO_MEMORY_FAIL                            0x00000002UL
+
+// No Pico Technology device could be found.
+#define PICO_NOT_FOUND                              0x00000003UL
+
+// Unable to download firmware.
+#define PICO_FW_FAIL                                0x00000004UL
+
+// The driver is busy opening a device.
+#define PICO_OPEN_OPERATION_IN_PROGRESS             0x00000005UL
+
+// An unspecified failure occurred.
+#define PICO_OPERATION_FAILED                       0x00000006UL
+
+// The PicoScope is not responding to commands from the PC.
+#define PICO_NOT_RESPONDING                         0x00000007UL
+
+// The configuration information in the PicoScope is corrupt or missing.
+#define PICO_CONFIG_FAIL                            0x00000008UL
+
+// The picopp.sys file is too old to be used with the device driver.
+#define PICO_KERNEL_DRIVER_TOO_OLD                  0x00000009UL
+
+// The EEPROM has become corrupt, so the device will use a default setting.
+#define PICO_EEPROM_CORRUPT                         0x0000000AUL
+
+// The operating system on the PC is not supported by this driver.
+#define PICO_OS_NOT_SUPPORTED                       0x0000000BUL
+
+// There is no device with the handle value passed.
+#define PICO_INVALID_HANDLE                         0x0000000CUL
+
+// A parameter value is not valid.
+#define PICO_INVALID_PARAMETER                      0x0000000DUL
+
+// The timebase is not supported or is invalid.
+#define PICO_INVALID_TIMEBASE                       0x0000000EUL
+
+// The voltage range is not supported or is invalid.
+#define PICO_INVALID_VOLTAGE_RANGE                  0x0000000FUL
+
+// The channel number is not valid on this device or no channels have been set.
+#define PICO_INVALID_CHANNEL                        0x00000010UL
+
+// The channel set for a trigger is not available on this device.
+#define PICO_INVALID_TRIGGER_CHANNEL                0x00000011UL
+
+// The channel set for a condition is not available on this device.
+#define PICO_INVALID_CONDITION_CHANNEL              0x00000012UL
+
+// The device does not have a signal generator.
+#define PICO_NO_SIGNAL_GENERATOR                    0x00000013UL
+
+// Streaming has failed to start or has stopped without user request.
+#define PICO_STREAMING_FAILED                       0x00000014UL
+
+// Block failed to start - a parameter may have been set wrongly.
+#define PICO_BLOCK_MODE_FAILED                      0x00000015UL
+
+// A parameter that was required is NULL.
+#define PICO_NULL_PARAMETER                         0x00000016UL
+
+// The current functionality is not available while using ETS capture mode.
+#define PICO_ETS_MODE_SET                           0x00000017UL
+
+// No data is available from a run block call.
+#define PICO_DATA_NOT_AVAILABLE                     0x00000018UL
+
+// The buffer passed for the information was too small.
+#define PICO_STRING_BUFFER_TO_SMALL                 0x00000019UL
+
+// ETS is not supported on this device.
+#define PICO_ETS_NOT_SUPPORTED                      0x0000001AUL
+
+// The auto trigger time is less than the time it will take to collect the pre-trigger data.
+#define PICO_AUTO_TRIGGER_TIME_TO_SHORT             0x0000001BUL
+
+// The collection of data has stalled as unread data would be overwritten.
+#define PICO_BUFFER_STALL                           0x0000001CUL
+
+// Number of samples requested is more than available in the current memory segment.
+#define PICO_TOO_MANY_SAMPLES                       0x0000001DUL
+
+// Not possible to create number of segments requested.
+#define PICO_TOO_MANY_SEGMENTS                      0x0000001EUL
+
+// A null pointer has been passed in the trigger function or one of the parameters is out of range.
+#define PICO_PULSE_WIDTH_QUALIFIER                  0x0000001FUL
+
+// One or more of the hold-off parameters are out of range.
+#define PICO_DELAY                                  0x00000020UL
+
+// One or more of the source details are incorrect.
+#define	PICO_SOURCE_DETAILS                         0x00000021UL
+
+// One or more of the conditions are incorrect.
+#define PICO_CONDITIONS                             0x00000022UL
+
+// The driver's thread is currently in the <API>Ready callback
+// function and therefore the action cannot be carried out.
+#define	PICO_USER_CALLBACK                          0x00000023UL
+
+// An attempt is being made to get stored data while streaming.
+// Either stop streaming by calling <API>Stop, or use <API>GetStreamingLatestValues.
+#define PICO_DEVICE_SAMPLING                        0x00000024UL
+
+// Data is unavailable because a run has not been completed.
+#define PICO_NO_SAMPLES_AVAILABLE                   0x00000025UL
+
+// The memory segment index is out of range.
+#define PICO_SEGMENT_OUT_OF_RANGE                   0x00000026UL
+
+// The device is busy so data cannot be returned yet.
+#define PICO_BUSY                                   0x00000027UL
+
+// The start time to get stored data is out of range.
+#define PICO_STARTINDEX_INVALID                     0x00000028UL
+
+// The information number requested is not a valid number.
+#define PICO_INVALID_INFO                           0x00000029UL
+
+// The handle is invalid so no information is available about the device.
+// Only PICO_DRIVER_VERSION is available.
+#define PICO_INFO_UNAVAILABLE                       0x0000002AUL
+
+// The sample interval selected for streaming is out of range.
+#define PICO_INVALID_SAMPLE_INTERVAL                0x0000002BUL
+
+// ETS is set but no trigger has been set. A trigger setting is required for ETS.
+#define PICO_TRIGGER_ERROR                          0x0000002CUL
+
+// Driver cannot allocate memory.
+#define PICO_MEMORY                                 0x0000002DUL
+
+// Incorrect parameter passed to the signal generator.
+#define PICO_SIG_GEN_PARAM                          0x0000002EUL
+
+// Conflict between the shots and sweeps parameters sent to the signal generator.
+#define PICO_SHOTS_SWEEPS_WARNING                   0x0000002FUL
+
+// A software trigger has been sent but the trigger source is not a software trigger.
+#define PICO_SIGGEN_TRIGGER_SOURCE                  0x00000030UL
+
+// An <API>SetTrigger call has found a conflict between the trigger source and the AUX output enable.
+#define PICO_AUX_OUTPUT_CONFLICT                    0x00000031UL
+
+// ETS mode is being used and AUX is set as an input.
+#define PICO_AUX_OUTPUT_ETS_CONFLICT                0x00000032UL
+
+// Attempt to set different EXT input thresholds set for signal generator and oscilloscope trigger.
+#define PICO_WARNING_EXT_THRESHOLD_CONFLICT         0x00000033UL
+
+// An <API>SetTrigger... function has set AUX as an output and the signal generator is using it as a trigger.
+#define PICO_WARNING_AUX_OUTPUT_CONFLICT            0x00000034UL
+
+// The combined peak-to-peak voltage and the analog offset voltage exceed the maximum voltage the signal generator can produce.
+#define PICO_SIGGEN_OUTPUT_OVER_VOLTAGE             0x00000035UL
+
+// NULL pointer passed as delay parameter.
+#define PICO_DELAY_NULL                             0x00000036UL
+
+// The buffers for overview data have not been set while streaming.
+#define PICO_INVALID_BUFFER                         0x00000037UL
+
+// The analog offset voltage is out of range.
+#define PICO_SIGGEN_OFFSET_VOLTAGE                  0x00000038UL
+
+// The analog peak-to-peak voltage is out of range.
+#define PICO_SIGGEN_PK_TO_PK                        0x00000039UL
+
+// A block collection has been cancelled.
+#define PICO_CANCELLED                              0x0000003AUL
+
+// The segment index is not currently being used.
+#define PICO_SEGMENT_NOT_USED                       0x0000003BUL
+
+// The wrong GetValues function has been called for the collection mode in use.
+#define PICO_INVALID_CALL                           0x0000003CUL
+
+#define PICO_GET_VALUES_INTERRUPTED                 0x0000003DUL
+
+// The function is not available.
+#define PICO_NOT_USED                               0x0000003FUL
+
+// The aggregation ratio requested is out of range.
+#define PICO_INVALID_SAMPLERATIO                    0x00000040UL
+
+// Device is in an invalid state.
+#define PICO_INVALID_STATE                          0x00000041UL
+
+// The number of segments allocated is fewer than the number of captures requested.
+#define PICO_NOT_ENOUGH_SEGMENTS                    0x00000042UL
+
+// A driver function has already been called and not yet finished.
+// Only one call to the driver can be made at any one time.
+#define PICO_DRIVER_FUNCTION                        0x00000043UL
+
+// Not used.
+#define PICO_RESERVED                               0x00000044UL
+
+// An invalid coupling type was specified in <API>SetChannel.
+#define PICO_INVALID_COUPLING                       0x00000045UL
+
+// An attempt was made to get data before a data buffer was defined.
+#define PICO_BUFFERS_NOT_SET                        0x00000046UL
+
+// The selected downsampling mode (used for data reduction) is not allowed.
+#define PICO_RATIO_MODE_NOT_SUPPORTED               0x00000047UL
+
+// Aggregation was requested in rapid block mode.
+#define PICO_RAPID_NOT_SUPPORT_AGGREGATION          0x00000048UL
+
+// An invalid parameter was passed to <API>SetTriggerChannelProperties(V2).
+#define PICO_INVALID_TRIGGER_PROPERTY               0x00000049UL
+
+// The driver was unable to contact the oscilloscope.
+#define PICO_INTERFACE_NOT_CONNECTED                0x0000004AUL
+
+// Resistance-measuring mode is not allowed in conjunction with the specified probe.
+#define PICO_RESISTANCE_AND_PROBE_NOT_ALLOWED       0x0000004BUL
+
+// The device was unexpectedly powered down.
+#define PICO_POWER_FAILED                           0x0000004CUL
+
+// A problem occurred in <API>SetSigGenBuiltIn or <API>SetSigGenArbitrary.
+#define PICO_SIGGEN_WAVEFORM_SETUP_FAILED           0x0000004DUL
+
+// FPGA not successfully set up.
+#define PICO_FPGA_FAIL                              0x0000004EUL
+
+#define PICO_POWER_MANAGER                          0x0000004FUL
+
+// An impossible analog offset value was specified in <API>SetChannel.
+#define PICO_INVALID_ANALOGUE_OFFSET                0x00000050UL
+
+// There is an error within the device hardware.
+#define PICO_PLL_LOCK_FAILED                        0x00000051UL
+
+// There is an error within the device hardware.
+#define PICO_ANALOG_BOARD                           0x00000052UL
+
+// Unable to configure the signal generator.
+#define PICO_CONFIG_FAIL_AWG                        0x00000053UL
+
+// The FPGA cannot be initialized, so unit cannot be opened.
+#define PICO_INITIALISE_FPGA                        0x00000054UL
+
+// The frequency for the external clock is not within 15% of the nominal value.
+#define PICO_EXTERNAL_FREQUENCY_INVALID             0x00000056UL
+
+// The FPGA could not lock the clock signal.
+#define PICO_CLOCK_CHANGE_ERROR                     0x00000057UL
+
+// You are trying to configure the AUX input as both a trigger and a reference clock.
+#define PICO_TRIGGER_AND_EXTERNAL_CLOCK_CLASH       0x00000058UL
+
+// You are trying to configure the AUX input as both a pulse width qualifier and a reference clock.
+#define PICO_PWQ_AND_EXTERNAL_CLOCK_CLASH           0x00000059UL
+
+// The requested scaling file cannot be opened.
+#define PICO_UNABLE_TO_OPEN_SCALING_FILE            0x0000005AUL
+
+// The frequency of the memory is reporting incorrectly.
+#define PICO_MEMORY_CLOCK_FREQUENCY                 0x0000005BUL
+
+// The I2C that is being actioned is not responding to requests.
+#define PICO_I2C_NOT_RESPONDING                     0x0000005CUL
+
+// There are no captures available and therefore no data can be returned.
+#define PICO_NO_CAPTURES_AVAILABLE                  0x0000005DUL
+
+// The number of trigger channels is greater than 4,
+// except for a PicoScope 4824 where 8 channels are allowed for rising/falling/rising_or_falling trigger directions.
+#define PICO_TOO_MANY_TRIGGER_CHANNELS_IN_USE				0x0000005FUL
+
+// If you have specified a trigger direction which is not allowed, for example specifying PICO_ABOVE
+// without another condition which crosses a threshold on another channel.
+#define PICO_INVALID_TRIGGER_DIRECTION							0x00000060UL
+
+// When more than 4 trigger channels are set and their trigger condition states are not <API>_CONDITION_TRUE.
+#define PICO_INVALID_TRIGGER_STATES									0x00000061UL
+
+// The capture mode the device is currently running in does not support the current request.
+#define PICO_NOT_USED_IN_THIS_CAPTURE_MODE          0x0000005EUL
+
+#define PICO_GET_DATA_ACTIVE                        0x00000103UL
+
+// Codes 104 to 10B are used by the PT104 (USB) when connected via the Network Socket.
+
+// The device is currently connected via the IP Network socket and thus the call made is not supported.
+#define PICO_IP_NETWORKED                           0x00000104UL
+
+// An incorrect IP address has been passed to the driver.
+#define PICO_INVALID_IP_ADDRESS                     0x00000105UL
+
+// The IP socket has failed.
+#define PICO_IPSOCKET_FAILED                        0x00000106UL
+
+// The IP socket has timed out.
+#define PICO_IPSOCKET_TIMEDOUT                      0x00000107UL
+
+// Failed to apply the requested settings.
+#define PICO_SETTINGS_FAILED                        0x00000108UL
+
+// The network connection has failed.
+#define PICO_NETWORK_FAILED                         0x00000109UL
+
+// Unable to load the WS2 DLL.
+#define PICO_WS2_32_DLL_NOT_LOADED                  0x0000010AUL
+
+// The specified IP port is invalid.
+#define PICO_INVALID_IP_PORT                        0x0000010BUL
+
+// The type of coupling requested is not supported on the opened device.
+#define PICO_COUPLING_NOT_SUPPORTED                 0x0000010CUL
+
+// Bandwidth limiting is not supported on the opened device.
+#define PICO_BANDWIDTH_NOT_SUPPORTED                0x0000010DUL
+
+// The value requested for the bandwidth limit is out of range.
+#define PICO_INVALID_BANDWIDTH                      0x0000010EUL
+
+// The arbitrary waveform generator is not supported by the opened device.
+#define PICO_AWG_NOT_SUPPORTED                      0x0000010FUL
+
+// Data has been requested with ETS mode set but run block has not been called,
+// or stop has been called.
+#define PICO_ETS_NOT_RUNNING                        0x00000110UL
+
+// White noise output is not supported on the opened device.
+#define PICO_SIG_GEN_WHITENOISE_NOT_SUPPORTED       0x00000111UL
+
+// The wave type requested is not supported by the opened device.
+#define PICO_SIG_GEN_WAVETYPE_NOT_SUPPORTED         0x00000112UL
+
+// The requested digital port number is out of range (MSOs only).
+#define PICO_INVALID_DIGITAL_PORT                   0x00000113UL
+
+// The digital channel is not in the range <API>_DIGITAL_CHANNEL0 to
+// <API>_DIGITAL_CHANNEL15, the digital channels that are supported.
+#define PICO_INVALID_DIGITAL_CHANNEL                0x00000114UL
+
+// The digital trigger direction is not a valid trigger direction and should be equal
+// in value to one of the <API>_DIGITAL_DIRECTION enumerations.
+#define PICO_INVALID_DIGITAL_TRIGGER_DIRECTION      0x00000115UL
+
+// Signal generator does not generate pseudo-random binary sequence.
+#define	PICO_SIG_GEN_PRBS_NOT_SUPPORTED             0x00000116UL
+
+// When a digital port is enabled, ETS sample mode is not available for use.
+#define PICO_ETS_NOT_AVAILABLE_WITH_LOGIC_CHANNELS  0x00000117UL
+
+// There has been no new sample taken, this value has already been returned previously.
+#define PICO_WARNING_REPEAT_VALUE                   0x00000118UL
+
+// The DC power supply is connected.
+#define PICO_POWER_SUPPLY_CONNECTED                 0x00000119UL
+
+// The DC power supply is not connected.
+// For many 4+ Channel devices this will mean a restricted feature set is offered e.g. for a 4 channel device - C and D are usually disabled.
+// Check the respective API programmers guide of your device for the full details.
+#define PICO_POWER_SUPPLY_NOT_CONNECTED             0x0000011AUL
+
+// Incorrect power mode passed for current power source.
+#define PICO_POWER_SUPPLY_REQUEST_INVALID           0x0000011BUL
+
+// The supply voltage from the USB source is too low.
+#define PICO_POWER_SUPPLY_UNDERVOLTAGE              0x0000011CUL
+
+// The oscilloscope is in the process of capturing data.
+#define PICO_CAPTURING_DATA                         0x0000011DUL
+
+// A USB 3.0 device is connected to a non-USB 3.0 port.
+#define PICO_USB3_0_DEVICE_NON_USB3_0_PORT          0x0000011EUL
+
+// A function has been called that is not supported by the current device.
+#define PICO_NOT_SUPPORTED_BY_THIS_DEVICE           0x0000011FUL
+
+// The device resolution is invalid (out of range).
+#define PICO_INVALID_DEVICE_RESOLUTION              0x00000120UL
+
+// The number of channels that can be enabled is limited in 15 and 16-bit modes.
+// (Flexible Resolution Oscilloscopes only)
+#define PICO_INVALID_NUMBER_CHANNELS_FOR_RESOLUTION 0x00000121UL
+
+// USB power not sufficient for all requested channels.
+#define PICO_CHANNEL_DISABLED_DUE_TO_USB_POWERED    0x00000122UL
+
+// The signal generator does not have a configurable DC offset.
+#define PICO_SIGGEN_DC_VOLTAGE_NOT_CONFIGURABLE     0x00000123UL
+
+// An attempt has been made to define pre-trigger delay without first enabling a trigger.
+#define PICO_NO_TRIGGER_ENABLED_FOR_TRIGGER_IN_PRE_TRIG  0x00000124UL
+
+// An attempt has been made to define pre-trigger delay without first arming a trigger.
+#define PICO_TRIGGER_WITHIN_PRE_TRIG_NOT_ARMED           0x00000125UL
+
+// Pre-trigger delay and post-trigger delay cannot be used at the same time.
+#define PICO_TRIGGER_WITHIN_PRE_NOT_ALLOWED_WITH_DELAY   0x00000126UL
+
+// The array index points to a nonexistent trigger.
+#define PICO_TRIGGER_INDEX_UNAVAILABLE                   0x00000127UL
+
+#define PICO_AWG_CLOCK_FREQUENCY									0x00000128UL
+
+// There are more than 4 analog channels with a trigger condition set.
+#define PICO_TOO_MANY_CHANNELS_IN_USE							0x00000129UL
+
+// The condition parameter is a null pointer.
+#define PICO_NULL_CONDITIONS											0x0000012AUL
+
+// There is more than one condition pertaining to the same channel.
+#define PICO_DUPLICATE_CONDITION_SOURCE						0x0000012BUL
+
+// The parameter relating to condition information is out of range.
+#define PICO_INVALID_CONDITION_INFO								0x0000012CUL
+
+// Reading the meta data has failed.
+#define PICO_SETTINGS_READ_FAILED									0x0000012DUL
+
+// Writing the meta data has failed.
+#define PICO_SETTINGS_WRITE_FAILED								0x0000012EUL
+
+// A parameter has a value out of the expected range.
+#define PICO_ARGUMENT_OUT_OF_RANGE								0x0000012FUL
+
+// The driver does not support the hardware variant connected.
+#define PICO_HARDWARE_VERSION_NOT_SUPPORTED				0x00000130UL
+
+// The driver does not support the digital hardware variant connected.
+#define PICO_DIGITAL_HARDWARE_VERSION_NOT_SUPPORTED				0x00000131UL
+
+// The driver does not support the analog hardware variant connected.
+#define PICO_ANALOGUE_HARDWARE_VERSION_NOT_SUPPORTED				0x00000132UL
+
+// Converting a channel's ADC value to resistance has failed.
+#define PICO_UNABLE_TO_CONVERT_TO_RESISTANCE			0x00000133UL
+
+// The channel is listed more than once in the function call.
+#define PICO_DUPLICATED_CHANNEL										0x00000134UL
+
+// The range cannot have resistance conversion applied.
+#define PICO_INVALID_RESISTANCE_CONVERSION				0x00000135UL
+
+// An invalid value is in the max buffer.
+#define PICO_INVALID_VALUE_IN_MAX_BUFFER					0x00000136UL
+
+// An invalid value is in the min buffer.
+#define PICO_INVALID_VALUE_IN_MIN_BUFFER					0x00000137UL
+
+// When calculating the frequency for phase conversion,
+// the frequency is greater than that supported by the current variant.
+#define PICO_SIGGEN_FREQUENCY_OUT_OF_RANGE				0x00000138UL
+
+// The device's EEPROM is corrupt. Contact Pico Technology support: https://www.picotech.com/tech-support.
+#define PICO_EEPROM2_CORRUPT											0x00000139UL
+
+// The EEPROM has failed.
+#define PICO_EEPROM2_FAIL													0x0000013AUL
+
+// The serial buffer is too small for the required information.
+#define PICO_SERIAL_BUFFER_TOO_SMALL							0x0000013BUL
+
+// The signal generator trigger and the external clock have both been set.
+// This is not allowed.
+#define PICO_SIGGEN_TRIGGER_AND_EXTERNAL_CLOCK_CLASH 0x0000013CUL
+
+// The AUX trigger was enabled and the external clock has been enabled,
+// so the AUX has been automatically disabled.
+#define PICO_WARNING_SIGGEN_AUXIO_TRIGGER_DISABLED 0x0000013DUL
+
+// The AUX I/O was set as a scope trigger and is now being set as a signal generator
+// gating trigger. This is not allowed.
+#define PICO_SIGGEN_GATING_AUXIO_NOT_AVAILABLE	 	 0x00000013EUL
+
+// The AUX I/O was set by the signal generator as a gating trigger and is now being set
+// as a scope trigger. This is not allowed.
+#define PICO_SIGGEN_GATING_AUXIO_ENABLED				 	 0x00000013FUL
+
+// A resource has failed to initialise.
+#define PICO_RESOURCE_ERROR												 0x00000140UL
+
+// The temperature type is out of range.
+#define PICO_TEMPERATURE_TYPE_INVALID							 0x000000141UL
+
+// A requested temperature type is not supported on this device.
+#define PICO_TEMPERATURE_TYPE_NOT_SUPPORTED				 0x000000142UL
+
+// A read/write to the device has timed out.
+#define PICO_TIMEOUT															 0x00000143UL
+
+// The device cannot be connected correctly.
+#define PICO_DEVICE_NOT_FUNCTIONING							   0x00000144UL
+
+// The driver has experienced an unknown error and is unable to recover from this error.
+#define PICO_INTERNAL_ERROR												 0x00000145UL
+
+// Used when opening units via IP and more than multiple units have the same IP address.
+#define PICO_MULTIPLE_DEVICES_FOUND								 0x00000146UL
+
+#define PICO_WARNING_NUMBER_OF_SEGMENTS_REDUCED 	 					0x00000147UL
+
+// The calibration pin states argument is out of range.
+#define PICO_CAL_PINS_STATES											0x00000148UL
+
+// The calibration pin frequency argument is out of range.
+#define PICO_CAL_PINS_FREQUENCY										0x00000149UL
+
+// The calibration pin amplitude argument is out of range.
+#define PICO_CAL_PINS_AMPLITUDE										0x0000014AUL
+
+// The calibration pin wavetype argument is out of range.
+#define PICO_CAL_PINS_WAVETYPE										0x0000014BUL
+
+// The calibration pin offset argument is out of range.
+#define PICO_CAL_PINS_OFFSET											0x0000014CUL
+
+// The probe's identity has a problem.
+#define PICO_PROBE_FAULT													0x0000014DUL
+
+// The probe has not been identified.
+#define PICO_PROBE_IDENTITY_UNKNOWN								0x0000014EUL
+
+// Enabling the probe would cause the device to exceed the allowable current limit.
+#define PICO_PROBE_POWER_DC_POWER_SUPPLY_REQUIRED 0x0000014FUL
+
+// The DC power supply is connected; enabling the probe would cause the device to exceed the
+// allowable current limit.
+#define PICO_PROBE_NOT_POWERED_WITH_DC_POWER_SUPPLY 0x00000150UL
+
+// Failed to complete probe configuration.
+#define	PICO_PROBE_CONFIG_FAILURE									0x00000151UL
+
+// Failed to set the callback function, as currently in current callback function.
+#define	PICO_PROBE_INTERACTION_CALLBACK						0x00000152UL
+
+// The probe has been verified but not known on this driver.
+#define	PICO_UNKNOWN_INTELLIGENT_PROBE						0x00000153UL
+
+// The intelligent probe cannot be verified.
+#define	PICO_INTELLIGENT_PROBE_CORRUPT						0x00000154UL
+
+// The callback is null, probe collection will only start when
+// first callback is a none null pointer.
+#define PICO_PROBE_COLLECTION_NOT_STARTED					0x00000155UL
+
+// The current drawn by the probe(s) has exceeded the allowed limit.
+#define PICO_PROBE_POWER_CONSUMPTION_EXCEEDED    0x00000156UL
+
+// The channel range limits have changed due to connecting or disconnecting a probe
+// the channel has been enabled.
+#define PICO_WARNING_PROBE_CHANNEL_OUT_OF_SYNC 0x00000157UL
+
+#define PICO_ENDPOINT_MISSING									 0x00000158UL
+#define PICO_UNKNOWN_ENDPOINT_REQUEST							 0x00000159UL
+
+// The ADC on board the device has not been correctly identified.
+#define PICO_ADC_TYPE_ERROR													0x0000015AUL
+
+#define PICO_FPGA2_FAILED														0x0000015BUL
+
+#define PICO_FPGA2_DEVICE_STATUS										0x0000015CUL
+
+#define PICO_ENABLE_PROGRAM_FPGA2_FAILED						0x0000015DUL
+#define PICO_NO_CHANNELS_OR_PORTS_ENABLED									0x0000015EUL
+
+#define PICO_INVALID_RATIO_MODE											0x0000015FUL
+
+#define PICO_READS_NOT_SUPPORTED_IN_CURRENT_CAPTURE_MODE 0x00000160UL
+
+// These selection tests can be masked together to show that mode than one read selection has failed the tests,
+// therefore theses error codes cover 0x00000161UL to 0x0000016FUL.
+#define PICO_TRIGGER_READ_SELECTION_CHECK_FAILED						0x00000161UL
+#define PICO_DATA_READ1_SELECTION_CHECK_FAILED						0x00000162UL
+#define PICO_DATA_READ2_SELECTION_CHECK_FAILED						0x00000164UL
+#define PICO_DATA_READ3_SELECTION_CHECK_FAILED						0x00000168UL
+
+// The requested read is not one of the reads available in enPicoReadSelection.
+#define PICO_READ_SELECTION_OUT_OF_RANGE						0x00000170UL
+
+// The downsample ratio options cannot be combined together for this request.
+#define PICO_MULTIPLE_RATIO_MODES										0x00000171UL
+
+// The enPicoReadSelection request has no samples available.
+#define PICO_NO_SAMPLES_READ			                  0x00000172UL
+
+// The enPicoReadSelection did not include one of the downsample ratios now requested.
+#define PICO_RATIO_MODE_NOT_REQUESTED								0x00000173UL
+
+// No read requests have been made.
+#define PICO_NO_USER_READ_REQUESTS_SET							0x00000174UL
+
+// The parameter for <number of values> cannot be zero.
+#define PICO_ZERO_SAMPLES_INVALID										0x00000175UL
+
+// The analog hardware cannot be identified; contact Pico Technology Technical Support.
+#define	PICO_ANALOGUE_HARDWARE_MISSING							0x00000176UL
+
+// Setting of the analog hardware pins failed.
+#define PICO_ANALOGUE_HARDWARE_PINS									0x00000177UL
+
+// An SMPS fault has occurred.
+#define PICO_ANALOGUE_HARDWARE_SMPS_FAULT						0x00000178UL
+
+// There appears to be a conflict between the expected and actual hardware in the device; contact Pico Technology Technical Support.
+#define PICO_DIGITAL_ANALOGUE_HARDWARE_CONFLICT			0x00000179UL
+
+// One or more of the enPicoRatioMode requested do not have a data buffer set.
+#define PICO_RATIO_MODE_BUFFER_NOT_SET							0x0000017AUL
+
+// The resolution is valid but not supported by the opened device.
+#define PICO_RESOLUTION_NOT_SUPPORTED_BY_VARIANT		0x0000017BUL
+
+// The requested trigger threshold is out of range for the current device resolution.
+#define PICO_THRESHOLD_OUT_OF_RANGE									0x0000017CUL
+
+// The simple trigger only supports upper edge direction options.
+#define PICO_INVALID_SIMPLE_TRIGGER_DIRECTION				0x0000017DUL
+
+// The aux trigger is not supported on this variant.
+#define PICO_AUX_NOT_SUPPORTED											0x0000017EUL
+
+// The trigger directions pointer may not be null.
+#define PICO_NULL_DIRECTIONS												0x0000017FUL
+
+// The trigger channel properties pointer may not be null.
+#define PICO_NULL_CHANNEL_PROPERTIES								0x00000180UL
+
+// A trigger is set on a channel that has not been enabled.
+#define PICO_TRIGGER_CHANNEL_NOT_ENABLED						0x00000181UL
+
+// A trigger condition has been set but a trigger property not set.
+#define PICO_CONDITION_HAS_NO_TRIGGER_PROPERTY			0x00000182UL
+
+// When requesting trigger data, this option can only be combined with the segment header ratio mode flag.
+#define PICO_RATIO_MODE_TRIGGER_MASKING_INVALID			0x00000183UL
+
+// The trigger data buffer must be 40 or more samples in size.
+#define PICO_TRIGGER_DATA_REQUIRES_MIN_BUFFER_SIZE_OF_40_SAMPLES 0x00000184UL
+
+// The number of requested waveforms is greater than the number of memory segments allocated.
+#define PICO_NO_OF_CAPTURES_OUT_OF_RANGE						0x00000185UL
+
+// When requesting segment header information, the segment header does not require a data buffer,
+// to get the segment information use GetTriggerInfo.
+#define PICO_RATIO_MODE_SEGMENT_HEADER_DOES_NOT_REQUIRE_BUFFERS	0x00000186UL
+
+// Use GetTriggerInfo to retrieve the segment header information.
+#define PICO_FOR_SEGMENT_HEADER_USE_GETTRIGGERINFO	0x00000187UL
+
+// A read request has not been set.
+#define PICO_READ_NOT_SET														0x00000188UL
+
+// The expected and actual states of the ADCs do not match.
+#define PICO_ADC_SETTING_MISMATCH										0x00000189UL
+
+// The requested data type is not one of the enPicoDataType listed.
+#define PICO_DATATYPE_INVALID												0x0000018AUL
+
+// The down sample ratio mode requested does not support the enPicoDataType option chosen.
+#define PICO_RATIO_MODE_DOES_NOT_SUPPORT_DATATYPE		0x0000018BUL
+
+// The channel combination is not valid for the resolution.
+#define PICO_CHANNEL_COMBINATION_NOT_VALID_IN_THIS_RESOLUTION 0x0000018CUL
+
+
+#define PICO_USE_8BIT_RESOLUTION										0x0000018DUL
+
+// The buffer for minimum data values and maximum data values are the same buffers.
+#define PICO_AGGREGATE_BUFFERS_SAME_POINTER					0x0000018EUL
+
+// The read request number of samples requested for an overlapped operation are more
+// than the total number of samples to capture.
+#define PICO_OVERLAPPED_READ_VALUES_OUT_OF_RANGE		0x0000018FUL
+
+// The overlapped read request has more segments specified than segments allocated.
+#define PICO_OVERLAPPED_READ_SEGMENTS_OUT_OF_RANGE	0x00000190UL
+
+// The number of channel combinations available are greater than the array size received.
+#define PICO_CHANNELFLAGSCOMBINATIONS_ARRAY_SIZE_TOO_SMALL 0x00000191UL
+
+// The number of captures is larger than the maximum number of segments allowed for the device variant.
+#define PICO_CAPTURES_EXCEEDS_NO_OF_SUPPORTED_SEGMENTS 0x00000192UL
+
+// The time unit requested is not one of the listed enPicoTimeUnits.
+#define PICO_TIME_UNITS_OUT_OF_RANGE								0x00000193UL
+
+// The number of samples parameter may not be zero.
+#define PICO_NO_SAMPLES_REQUESTED										0x00000194UL
+
+// The action requested is not listed in enPicoAction.
+#define PICO_INVALID_ACTION													0x00000195UL
+
+// When adding buffers for the same read request the buffers for all ratio mode requests have to be the same size.
+#define PICO_NO_OF_SAMPLES_NEED_TO_BE_EQUAL_WHEN_ADDING_BUFFERS 0x00000196UL
+
+// The data is being processed but there is no empty data buffers available, a new data buffer needs to be set sent to the driver
+// so that the data can be processed.
+#define PICO_WAITING_FOR_DATA_BUFFERS								0x00000197UL
+
+// when streaming data, only one read option is available.
+#define PICO_STREAMING_ONLY_SUPPORTS_ONE_READ				0x00000198UL
+
+// A clear read request is not one of the enPicoAction listed.
+#define PICO_CLEAR_DATA_BUFFER_INVALID					0x00000199UL
+
+// The combination of action flags are not allowed.
+#define PICO_INVALID_ACTION_FLAGS_COMBINATION				0x0000019AUL
+
+//  PICO_ADD request has been made but both data buffers are set to null and so there is nowhere to put the data.
+#define PICO_BOTH_MIN_AND_MAX_NULL_BUFFERS_CANNOT_BE_ADDED 0x0000019BUL
+
+// A conflict between the data buffers being set has occurred. Please use the PICO_CLEAR_ALL action to reset.
+#define PICO_CONFLICT_IN_SET_DATA_BUFFERS_CALL_REMOVE_DATA_BUFFER_TO_RESET 0x0000019CUL
+
+// While processing data, buffers cannot be removed from the data buffers list.
+#define PICO_REMOVING_DATA_BUFFER_ENTRIES_NOT_ALLOWED_WHILE_DATA_PROCESSING  0x0000019DUL
+
+//  An USB request has failed.
+#define PICO_CYUSB_REQUEST_FAILED						0x00000200UL
+
+// A request has been made to retrieve the latest streaming data, but with either a null pointer or an array size set to zero.
+#define PICO_STREAMING_DATA_REQUIRED				0x00000201UL
+
+// A buffer being set has a length that is invalid (ie less than zero).
+#define PICO_INVALID_NUMBER_OF_SAMPLES			0x00000202UL
+
+// The distribution size may not be zero.
+#define PICO_INVALID_DISTRIBUTION						0x00000203UL
+
+// The buffer length in bytes is greater than a 4-byte word.
+#define PICO_BUFFER_LENGTH_GREATER_THAN_INT32_T 0x00000204UL
+
+// The PLL has failed.
+#define PICO_PLL_MUX_OUT_FAILED             0x00000209UL
+
+// Pulse width only supports one direction.
+#define PICO_ONE_PULSE_WIDTH_DIRECTION_ALLOWED 0x0000020AUL
+
+// There is no external trigger available on the device specified by the handle.
+#define PICO_EXTERNAL_TRIGGER_NOT_SUPPORTED 0x0000020BUL
+
+// The condition parameter is a null pointer.
+#define PICO_NO_TRIGGER_CONDITIONS_SET							0x0000020CUL
+
+// The number of trigger channel properties it outside the allowed range (is less than zero).
+#define PICO_NO_OF_CHANNEL_TRIGGER_PROPERTIES_OUT_OF_RANGE 0x0000020DUL
+
+// A probe has been plugged into a channel, but can not be identified correctly.
+#define PICO_PROBE_COMPONENT_ERROR 0x0000020EUL
+
+// The probe is incompatible with the device channel it is connected to. This could lead to error in the measurements.
+#define PICO_INCOMPATIBLE_PROBE 0x0000020FUL
+
+// The requested channel for ETS triggering is not supported.
+#define PICO_INVALID_TRIGGER_CHANNEL_FOR_ETS              0x00000210UL
+
+// While the device is streaming the get values method is not available
+#define PICO_NOT_AVAILABLE_WHEN_STREAMING_IS_RUNNING 0x00000211UL
+
+// the requested state is not one of the enSharedTriggerWithinPreTrigger values
+#define PICO_INVALID_TRIGGER_WITHIN_PRE_TRIGGER_STATE 0x00000212UL
+
+// the number of captures have to be greater than zero
+#define PICO_ZERO_NUMBER_OF_CAPTURES_INVALID 0x00000213UL
+
+// the quantifier for a pointer, defining the length in bytes is invalid
+#define PICO_INVALID_LENGTH 0x00000214UL
+
+// the trigger delay is greater than supported by the hardware
+#define PICO_TRIGGER_DELAY_OUT_OF_RANGE 0x00000300UL
+
+// the requested threshold direction is not allowed with the specified channel
+#define PICO_INVALID_THRESHOLD_DIRECTION 0x00000301UL
+
+// the requested threshold mode is not allowed with the specified channel
+#define PICO_INVALID_THRESHOLD_MODE 0x00000302UL
+
+// The timebase is not supported or is invalid.
+#define PICO_TIMEBASE_NOT_SUPPORTED_BY_RESOLUTION 0x00000303UL
+
+// The device variant is not supported by this current driver.
+#define PICO_INVALID_VARIANT															0x00001000UL
+
+// The actual memory module does not match the expected memory module.
+#define PICO_MEMORY_MODULE_ERROR													0x00001001UL
+
+// A null pointer has been passed in the trigger function or one of the parameters is out of range.
+#define PICO_PULSE_WIDTH_QUALIFIER_LOWER_UPPER_CONFILCT  0x00002000UL
+
+// The pulse width qualifier type is not one of the listed options.
+#define PICO_PULSE_WIDTH_QUALIFIER_TYPE  0x00002001UL
+
+// The pulse width qualifier direction is not one of the listed options.
+#define PICO_PULSE_WIDTH_QUALIFIER_DIRECTION 0x00002002UL
+
+// The threshold range is not one of the listed options.
+#define PICO_THRESHOLD_MODE_OUT_OF_RANGE 0x00002003UL
+
+// The trigger direction and pulse width option conflict with each other.
+#define PICO_TRIGGER_AND_PULSEWIDTH_DIRECTION_IN_CONFLICT 0x00002004UL
+
+// The thresholds upper limits and thresholds lower limits conflict with each other.
+#define PICO_THRESHOLD_UPPER_LOWER_MISMATCH 0x00002005UL
+
+// The pulse width lower count is out of range.
+#define PICO_PULSE_WIDTH_LOWER_OUT_OF_RANGE	0x00002006UL
+
+// The pulse width upper count is out of range.
+#define PICO_PULSE_WIDTH_UPPER_OUT_OF_RANGE 0x00002007UL
+
+// The devices front panel has caused an error.
+#define PICO_FRONT_PANEL_ERROR 0x00002008UL
+
+// The actual and expected mode of the front panel do not match.
+#define PICO_FRONT_PANEL_MODE 0x0000200BUL
+
+// A front panel feature is not available or failed to configure.
+#define PICO_FRONT_PANEL_FEATURE 0x0000200CUL
+
+// When setting the pulse width conditions either the pointer is null or the number of conditions is set to zero.
+#define PICO_NO_PULSE_WIDTH_CONDITIONS_SET	0x0000200DUL
+
+// a trigger condition exists for a port, but the port has not been enabled
+#define PICO_TRIGGER_PORT_NOT_ENABLED 0x0000200EUL
+
+// a trigger condition exists for a port, but no digital channel directions have been set
+#define PICO_DIGITAL_DIRECTION_NOT_SET 0x0000200FUL
+
+#define PICO_I2C_DEVICE_INVALID_READ_COMMAND 0x00002010UL
+
+#define PICO_I2C_DEVICE_INVALID_RESPONSE 0x00002011UL
+
+#define PICO_I2C_DEVICE_INVALID_WRITE_COMMAND 0x00002012UL
+
+#define PICO_I2C_DEVICE_ARGUMENT_OUT_OF_RANGE 0x00002013UL
+
+// The actual and expected mode do not match.
+#define PICO_I2C_DEVICE_MODE 0x00002014UL
+
+// While trying to configure the device, set up failed.
+#define PICO_I2C_DEVICE_SETUP_FAILED 0x00002015UL
+
+// A feature is not available or failed to configure.
+#define PICO_I2C_DEVICE_FEATURE 0x00002016UL
+
+// The device did not pass the validation checks.
+#define PICO_I2C_DEVICE_VALIDATION_FAILED 0x00002017UL
+
+#define PICO_INTERNAL_HEADER_ERROR 0x00002018UL
+
+// The device couldn't write the channel settings due to a hardware fault
+#define PICO_FAILED_TO_WRITE_HARDWARE_FAULT 0x00002019UL
+
+// The number of MSO's edge transitions being set is not supported by this device (RISING, FALLING, or RISING_OR_FALLING).
+#define PICO_MSO_TOO_MANY_EDGE_TRANSITIONS_WHEN_USING_PULSE_WIDTH 0x00003000UL
+
+// A probe LED position requested is not one of the available probe positions in the ProbeLedPosition enum.
+#define PICO_INVALID_PROBE_LED_POSITION 0x00003001UL
+
+// The LED position is not supported by the selected variant.
+#define PICO_PROBE_LED_POSITION_NOT_SUPPORTED 0x00003002UL
+
+// A channel has more than one of the same LED position in the ProbeChannelLedSetting struct.
+#define PICO_DUPLICATE_PROBE_CHANNEL_LED_POSITION 0x00003003UL
+
+// Setting the probes LED has failed.
+#define PICO_PROBE_LED_FAILURE 0x00003004UL
+
+// Probe is not supported by the selected variant.
+#define PICO_PROBE_NOT_SUPPORTED_BY_THIS_DEVICE 0x00003005UL
+
+// The probe name is not in the list of enPicoConnectProbe enums.
+#define PICO_INVALID_PROBE_NAME 0x00003006UL
+
+// The number of colour settings are zero or a null pointer passed to the function.
+#define PICO_NO_PROBE_COLOUR_SETTINGS 0x00003007UL
+
+// Channel has no probe connected to it.
+#define PICO_NO_PROBE_CONNECTED_ON_REQUESTED_CHANNEL 0x00003008UL
+
+// Connected probe does not require calibration.
+#define PICO_PROBE_DOES_NOT_REQUIRE_CALIBRATION 0x00003009UL
+
+// Connected probe could not be calibrated - hardware fault is a possible cause.
+#define PICO_PROBE_CALIBRATION_FAILED 0x0000300AUL
+
+// A probe has been connected, but the version is not recognised.
+#define PICO_PROBE_VERSION_ERROR 0x0000300BUL
+
+// The channel with the frequency counter enabled has a probe connected that does not support this feature
+#define PICO_PROBE_DOES_NOT_SUPPORT_FREQUENCY_COUNTER 0x0000300CUL
+
+// The requested trigger time is to long for the selected variant.
+#define PICO_AUTO_TRIGGER_TIME_TOO_LONG   0x00004000UL
+
+// The MSO pod did not pass the validation checks.
+#define PICO_MSO_POD_VALIDATION_FAILED 0x00005000UL
+
+// No MSO pod found on the requested digital port.
+#define PICO_NO_MSO_POD_CONNECTED 0x00005001UL
+
+// the digital port enum value is not in the enPicoDigitalPortHysteresis declaration
+#define PICO_DIGITAL_PORT_HYSTERESIS_OUT_OF_RANGE 0x00005002UL
+
+#define PICO_MSO_POD_FAILED_UNIT 0x00005003UL
+
+// The device's EEPROM is corrupt. Contact Pico Technology support: https://www.picotech.com/tech-support.
+#define PICO_ATTENUATION_FAILED 0x00005004UL
+
+// a channel set to the 50Ohm Path has Tripped due to the input signal
+#define PICO_DC_50OHM_OVERVOLTAGE_TRIPPED 0x00005005UL
+
+// The MSO pod over current protection activated, unplug and replug the MSO pod 
+#define PICO_MSO_OVER_CURRENT_TRIPPED 0x00005006UL
+
+// Status error for when the device has overheated.
+#define PICO_NOT_RESPONDING_OVERHEATED 0x00005010UL
+
+// waiting for the device to capture timed out
+#define PICO_HARDWARE_CAPTURE_TIMEOUT 0x00006000UL
+
+// waiting for the device be ready for capture timed out
+#define PICO_HARDWARE_READY_TIMEOUT   0x00006001UL
+
+// the driver is performing a capture requested by RunStreaming or RunBlock
+// to interrupt this capture call Stop on the device first
+#define PICO_HARDWARE_CAPTURING_CALL_STOP   0x00006002UL
+
+// the number of samples is less than the minimum number allowed
+#define PICO_TOO_FEW_REQUESTED_STREAMING_SAMPLES 0x00007000UL
+
+// a streaming capture has been made but re-reading the data is not allowed
+#define PICO_STREAMING_REREAD_DATA_NOT_AVAILABLE 0x00007001UL
+
+// When requesting data only Raw and one of the following aggregation data types allowed
+//   - PICO_RATIO_MODE_AGGREGATE (Min Max),
+//     PICO_RATIO_MODE_DECIMATE,
+//     PICO_RATIO_MODE_AVERAGE and/or PICO_RATIO_MODE_SUM,
+//     PICO_RATIO_MODE_DISTRIBUTION
+//
+//	 average and sum are classed as one aggregation type
+#define PICO_STREAMING_COMBINATION_OF_RAW_DATA_AND_ONE_AGGREGATION_DATA_TYPE_ALLOWED 0x00007002UL
+
+// The time stamp per waveform segment has been reset.
+#define PICO_DEVICE_TIME_STAMP_RESET							0x01000000UL
+
+// When requesting the TriggerTimeOffset the trigger time has not been set.
+#define PICO_TRIGGER_TIME_NOT_REQUESTED						0x02000001UL
+
+// Trigger time buffer not set.
+#define PICO_TRIGGER_TIME_BUFFER_NOT_SET          0x02000002UL
+
+// The trigger time failed to be calculated.
+#define PICO_TRIGGER_TIME_FAILED_TO_CALCULATE     0x02000004UL
+
+// The trigger time failed to be calculated.
+#define PICO_TRIGGER_WITHIN_A_PRE_TRIGGER_FAILED_TO_CALCULATE 0x02000008UL
+
+// The trigger time stamp was not requested.
+#define PICO_TRIGGER_TIME_STAMP_NOT_REQUESTED			0x02000100UL
+
+// RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION cannot have a buffer set
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_DOES_NOT_REQUIRE_BUFFERS 0x02200000UL
+
+// it is not possible to set a buffer for RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION therefore
+// information is not available pertaining to samples
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_DOES_NOT_HAVE_BUFFERS 0x02200001UL
+
+// to get the trigger time use either GetTriggerInfo or GetTriggerTimeOffset api calls
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_USE_GETTRIGGERINFO 0x02200002UL
+
+
+// PICO_RATIO_MDOE_TRIGGER and RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION is not supported in streaming capture
+#define PICO_STREAMING_DOES_NOT_SUPPORT_TRIGGER_RATIO_MODES 0x02200003UL
+
+// only the PICO_TRIGGER_READ may be used to read PICO_RATIO_MODE_TRIGGER, and PICO_RATIO_MODE_TRIGGER_FOR_CALCULATION
+#define PICO_USE_THE_TRIGGER_READ 0x02200004UL
+
+// one of the PICO_DATA_READs should be used to read:
+// PICO_RATIO_MODE_RAW
+// PICO_RATIO_MODE_AGGREGATE
+// PICO_RATIO_MODE_DECIMATE
+// PICO_RATIO_MODE_AVERAGE
+#define PICO_USE_A_DATA_READ 0x02200005UL
+
+// trigger data always requires a PICO_INT16_T data type
+#define PICO_TRIGGER_READ_REQUIRES_INT16_T_DATA_TYPE 0x02200006UL
+
+// a ratio mode passed to the API call requires the number of samples to be greater than zero
+#define PICO_RATIO_MODE_REQUIRES_NUMBER_OF_SAMPLES_TO_BE_SET 0x02200007UL
+
+// Attempted to set up the signal generator with an inconsistent configuration.
+#define PICO_SIGGEN_SETTINGS_MISMATCH             0x03000010UL
+
+// The signal generator has been partially reconfigured and the new settings must be applied before it can be paused or restarted.
+#define PICO_SIGGEN_SETTINGS_CHANGED_CALL_APPLY   0x03000011UL
+
+// The wave type is not listed in enPicoWaveType.
+#define PICO_SIGGEN_WAVETYPE_NOT_SUPPORTED        0x03000012UL
+
+// The trigger type is not listed in enSigGenTrigType.
+#define PICO_SIGGEN_TRIGGERTYPE_NOT_SUPPORTED     0x03000013UL
+
+// The trigger source is not listed in enSigGenTrigSource.
+#define PICO_SIGGEN_TRIGGERSOURCE_NOT_SUPPORTED   0x03000014UL
+
+// The filter state is not listed in enPicoSigGenFilterState.
+#define PICO_SIGGEN_FILTER_STATE_NOT_SUPPORTED    0x03000015UL
+
+// The arbitrary waveform buffer is a null pointer.
+#define PICO_SIGGEN_NULL_PARAMETER                0x03000020UL
+
+// The arbitrary waveform buffer length is zero.
+#define PICO_SIGGEN_EMPTY_BUFFER_SUPPLIED         0x03000021UL
+
+// The sig gen voltage offset and peak to peak have not been set.
+#define PICO_SIGGEN_RANGE_NOT_SUPPLIED            0x03000022UL
+
+// The sig gen arbitrary waveform buffer not been set.
+#define PICO_SIGGEN_BUFFER_NOT_SUPPLIED           0x03000023UL
+
+// The sig gen frequency have not been set.
+#define PICO_SIGGEN_FREQUENCY_NOT_SUPPLIED        0x03000024UL
+
+// The sig gen sweep information has not been set.
+#define PICO_SIGGEN_SWEEP_INFO_NOT_SUPPLIED       0x03000025UL
+
+// The sig gen trigger information has not been set.
+#define PICO_SIGGEN_TRIGGER_INFO_NOT_SUPPLIED     0x03000026UL
+
+// The sig gen clock frequency have not been set.
+#define PICO_SIGGEN_CLOCK_FREQ_NOT_SUPPLIED       0x03000027UL
+
+// The sig gen arbitrary waveform buffer length is too long.
+#define PICO_SIGGEN_TOO_MANY_SAMPLES              0x03000030UL
+
+// The duty cycle value is out of range.
+#define PICO_SIGGEN_DUTYCYCLE_OUT_OF_RANGE        0x03000031UL
+
+// The number of cycles is out of range.
+#define PICO_SIGGEN_CYCLES_OUT_OF_RANGE           0x03000032UL
+
+// The pre-scaler is out of range.
+#define PICO_SIGGEN_PRESCALE_OUT_OF_RANGE         0x03000033UL
+
+// The sweep type is not listed in enPicoSweepType.
+#define PICO_SIGGEN_SWEEPTYPE_INVALID             0x03000034UL
+
+// A mismatch has occurred while checking the sweeps wave type.
+#define PICO_SIGGEN_SWEEP_WAVETYPE_MISMATCH       0x03000035UL
+
+// The sweeps or shots and trigger type are not valid when combined together.
+#define PICO_SIGGEN_INVALID_SWEEP_PARAMETERS      0x03000036UL
+
+// The sweep and prescaler are not valid when combined together.
+#define PICO_SIGGEN_SWEEP_PRESCALE_NOT_SUPPORTED  0x03000037UL
+
+// The potential applied to the AWG output exceeds the maximum voltage range of the AWG.
+#define PICO_AWG_OVER_VOLTAGE_RANGE               0x03000038UL
+
+// The reference signal cannot be locked to.
+#define PICO_NOT_LOCKED_TO_REFERENCE_FREQUENCY  0x03000039UL
+
+// (Linux only.) udev rules are incorrectly configured. The user does
+// not have read/write permissions on the device's file descriptor.
+#define PICO_PERMISSIONS_ERROR  0x03000040UL
+
+// The digital ports without analog channels are only allowed in 8-bit resolution.
+#define PICO_PORTS_WITHOUT_ANALOGUE_CHANNELS_ONLY_ALLOWED_IN_8BIT_RESOLUTION 0x03001000UL
+
+#define PICO_ANALOGUE_FRONTEND_MISSING 0x03003001UL
+#define PICO_FRONT_PANEL_MISSING 0x03003002UL
+#define PICO_ANALOGUE_FRONTEND_AND_FRONT_PANEL_MISSING 0x03003003UL
+
+// The digital board has reported an error to the driver
+#define PICO_DIGITAL_BOARD_HARDWARE_ERROR 0x03003800UL
+
+// checking if the firmware needs updating the updateRequired parameter is null
+#define PICO_FIRMWARE_UPDATE_REQUIRED_TO_USE_DEVICE_WITH_THIS_DRIVER		          0x03004000UL
+#define PICO_UPDATE_REQUIRED_NULL																				          0x03004001UL
+#define PICO_FIRMWARE_UP_TO_DATE																				          0x03004002UL
+#define PICO_FLASH_FAIL																									          0x03004003UL
+#define PICO_INTERNAL_ERROR_FIRMWARE_LENGTH_INVALID											          0x03004004UL
+#define PICO_INTERNAL_ERROR_FIRMWARE_NULL																          0x03004005UL
+#define PICO_FIRMWARE_FAILED_TO_BE_CHANGED															          0x03004006UL
+#define PICO_FIRMWARE_FAILED_TO_RELOAD																	          0x03004007UL
+#define PICO_FIRMWARE_FAILED_TO_BE_UPDATE																          0x03004008UL
+#define PICO_FIRMWARE_VERSION_OUT_OF_RANGE															          0x03004009UL
+
+#define PICO_OPTIONAL_BOOTLOADER_UPDATE_AVAILABLE_WITH_THIS_DRIVER	0x03005000UL
+#define PICO_BOOTLOADER_VERSION_NOT_AVAILABLE 0x03005001UL
+
+#define PICO_NO_APPS_AVAILABLE                                          0x03008000UL
+#define PICO_UNSUPPORTED_APP                                            0x03008001UL
+
+// the adc is powered down when trying to capture data
+#define PICO_ADC_POWERED_DOWN 0x03002000UL
+
+// An internal error has occurred and a watchdog timer has been called.
+#define PICO_WATCHDOGTIMER                        0x10000000UL
+
+// The picoipp.dll has not been found.
+#define PICO_IPP_NOT_FOUND                				0x10000001UL
+
+// A function in the picoipp.dll does not exist.
+#define PICO_IPP_NO_FUNCTION					            0x10000002UL
+
+// The Pico IPP call has failed.
+#define PICO_IPP_ERROR					                  0x10000003UL
+
+// Shadow calibration is not available on this device.
+#define PICO_SHADOW_CAL_NOT_AVAILABLE             0x10000004UL
+
+// Shadow calibration is currently disabled.
+#define PICO_SHADOW_CAL_DISABLED                  0x10000005UL
+
+// Shadow calibration error has occurred.
+#define PICO_SHADOW_CAL_ERROR                     0x10000006UL
+
+// The shadow calibration is corrupt.
+#define PICO_SHADOW_CAL_CORRUPT                   0x10000007UL
+
+// The memory on board the device has overflowed.
+#define PICO_DEVICE_MEMORY_OVERFLOW               0x10000008UL
+
+//The device Adc test failed.
+#define PICO_ADC_TEST_FAILURE                     0x10000010UL
+
+#define PICO_RESERVED_1														0x11000000UL
+
+// The PicoSource device is not ready to accept instructions.
+#define PICO_SOURCE_NOT_READY											0x20000000UL
+#define PICO_SOURCE_INVALID_BAUD_RATE							0x20000001UL
+#define PICO_SOURCE_NOT_OPENED_FOR_WRITE					0x20000002UL
+#define PICO_SOURCE_FAILED_TO_WRITE_DEVICE				0x20000003UL
+#define PICO_SOURCE_EEPROM_FAIL										0x20000004UL
+#define PICO_SOURCE_EEPROM_NOT_PRESENT 						0x20000005UL
+#define PICO_SOURCE_EEPROM_NOT_PROGRAMMED					0x20000006UL
+#define PICO_SOURCE_LIST_NOT_READY								0x20000007UL
+#define PICO_SOURCE_FTD2XX_NOT_FOUND							0x20000008UL
+#define PICO_SOURCE_FTD2XX_NO_FUNCTION						0x20000009UL
+
+typedef uint32_t PICO_STATUS;
+
+typedef enum enPicoStringValue
+{
+	PICO_SV_MEMORY,
+	PICO_SV_MEMORY_NO_OF_SEGMENTS,
+	PICO_SV_MEMORY_MAX_SAMPLES,
+
+	PICO_SV_NO_OF_CHANNELS,
+	PICO_SV_ARRAY_OF_CHANNELS,
+	PICO_SV_CHANNEL,
+	PICO_SV_CHANNEL_NAME,
+	PICO_SV_CHANNEL_RANGE,
+	PICO_SV_CHANNEL_COUPLING,
+	PICO_SV_CHANNEL_ENABLED,
+	PICO_SV_CHANNEL_ANALOGUE_OFFSET,
+	PICO_SV_CHANNEL_FILTER,
+
+	PICO_SV_TRIGGER,
+	PICO_SV_TRIGGER_AUXIO_OUTPUT_ENABLED,
+	PICO_SV_TRIGGER_AUTO_TRIGGER_MICROSECONDS,
+
+	PICO_SV_TRIGGER_PROPERTIES,
+	PICO_SV_NO_OF_TRIGGER_PROPERTIES,
+
+	PICO_SV_TRIGGER_PROPERTIES_CHANNEL,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_UPPER,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_UPPER_HYSTERESIS,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_LOWER,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_LOWER_HYSTERESIS,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_MODE,
+
+	PICO_SV_TRIGGER_ARRAY_OF_BLOCK_CONDITIONS,
+	PICO_SV_TRIGGER_NO_OF_BLOCK_CONDITIONS,
+	PICO_SV_TRIGGER_CONDITIONS,
+	PICO_SV_TRIGGER_NO_OF_CONDITIONS,
+	PICO_SV_TRIGGER_CONDITION_SOURCE,
+	PICO_SV_TRIGGER_CONDITION_STATE,
+
+	PICO_SV_TRIGGER_DIRECTION,
+	PICO_SV_TRIGGER_NO_OF_DIRECTIONS,
+	PICO_SV_TRIGGER_DIRECTION_CHANNEL,
+	PICO_SV_TRIGGER_DIRECTION_DIRECTION,
+
+	PICO_SV_TRIGGER_DELAY,
+	PICO_SV_TRIGGER_DELAY_MS,
+
+	PICO_SV_FREQUENCY_COUNTER,
+	PICO_SV_FREQUENCY_COUNTER_ENABLED,
+	PICO_SV_FREQUENCY_COUNTER_CHANNEL,
+	PICO_SV_FREQUENCY_COUNTER_RANGE,
+	PICO_SV_FREQUENCY_COUNTER_TRESHOLDMAJOR,
+	PICO_SV_FREQUENCY_COUNTER_TRESHOLDMINOR,
+
+	PICO_SV_PULSE_WIDTH_PROPERTIES,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_DIRECTION,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_LOWER,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_UPPER,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_TYPE,
+
+	PICO_SV_PULSE_WIDTH_ARRAY_OF_BLOCK_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_NO_OF_BLOCK_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_NO_OF_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_CONDITIONS_SOURCE,
+	PICO_SV_PULSE_WIDTH_CONDITIONS_STATE,
+
+	PICO_SV_SAMPLE_PROPERTIES,
+	PICO_SV_SAMPLE_PROPERTIES_PRE_TRIGGER_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_POST_TRIGGER_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_TIMEBASE,
+	PICO_SV_SAMPLE_PROPERTIES_NO_OF_CAPTURES,
+	PICO_SV_SAMPLE_PROPERTIES_RESOLUTION,
+
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_DOWN_SAMPLE_RATIO,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_DOWN_SAMPLE_RATIO_MODE,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_REQUERSTED_NO_OF_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_SEGMENT_INDEX_FROM,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_SEGMENT_INDEX_TO,
+
+	PICO_SV_SIGNAL_GENERATOR,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_WAVE_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_START_FREQUENCY,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_STOP_FREQUENCY,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_INCREMENT,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_DWELL_TIME,
+	PICO_SV_SIGNAL_GENERATOR_AWG,
+	PICO_SV_SIGNAL_GENERATOR_AWG_START_DELTA_PHASE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_STOP_DELTA_PHASE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_DELTA_PHASE_INCREMENT,
+	PICO_SV_SIGNAL_GENERATOR_AWG_DWELL_COUNT,
+	PICO_SV_SIGNAL_GENERATOR_AWG_INDEX_MODE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_WAVEFORM_SIZE,
+	PICO_SV_SIGNAL_GENERATOR_ARRAY_OF_AWG_WAVEFORM_VALUES,
+	PICO_SV_SIGNAL_GENERATOR_OFFSET_VOLTAGE,
+	PICO_SV_SIGNAL_GENERATOR_PK_TO_PK,
+	PICO_SV_SIGNAL_GENERATOR_OPERATION,
+	PICO_SV_SIGNAL_GENERATOR_SHOTS,
+	PICO_SV_SIGNAL_GENERATOR_SWEEPS,
+	PICO_SV_SIGNAL_GENERATOR_SWEEP_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_TRIGGER_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_TRIGGER_SOURCE,
+	PICO_SV_SIGNAL_GENERATOR_EXT_IN_THRESHOLD,
+
+	PICO_SV_ETS,
+	PICO_SV_ETS_STATE,
+	PICO_SV_ETS_CYCLE,
+	PICO_SV_ETS_INTERLEAVE,
+	PICO_SV_ETS_SAMPLE_TIME_PICOSECONDS
+
+} PICO_STRING_VALUE;
+
+#endif

+ 37 - 0
pico-tcp-service/pico-tcp-client/inc/PicoVersion.h

@@ -0,0 +1,37 @@
+/****************************************************************************
+ *
+ * Filename:    PicoVersion.h
+ * Copyright:   Pico Technology Limited 2018 - 2022
+ * Description:
+ *
+ * This header defines the version struct.
+ *
+ ****************************************************************************/
+
+#ifndef __PICOVERSION_H__
+#define __PICOVERSION_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#pragma pack(push, 1)
+
+typedef struct tPicoVersion
+{
+	int16_t major_;
+	int16_t minor_;
+	int16_t revision_;
+	int16_t build_;
+} PICO_VERSION;
+
+typedef struct tPicoFirmwareInfo {
+	PICO_INFO firmwareType;
+	PICO_VERSION currentVersion;
+	PICO_VERSION updateVersion;
+	uint16_t updateRequired;
+} PICO_FIRMWARE_INFO;
+
+#pragma pack(pop)
+
+#endif

+ 158 - 0
pico-tcp-service/pico-tcp-client/inc/pl1000Api.h

@@ -0,0 +1,158 @@
+/**************************************************************************
+*
+* Filename:    pl1000Api.h
+* Author:      MB & MAS
+* Description:
+*
+* This header defines the interface to driver routines for the
+* PicoLog 1000 Series Data Loggers.
+*
+* Copyright © 2009-2018 Pico Technology Ltd. All rights reserved.
+*
+*************************************************************************/
+#ifndef __PL1000API_H__
+#define  __PL1000API_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+	//	If you are dynamically linking pl1000.dll into your project #define DYNLINK
+	//  somewhere in your project before here.
+#ifdef DYNLINK
+  #define PREF1 typedef
+  #define PREF2
+  #define PREF3(x) (__stdcall *x)
+#else
+  #define PREF1
+  #ifdef _USRDLL
+    #define PREF2 __declspec(dllexport) __stdcall
+  #else
+    #define PREF2 __declspec(dllimport) __stdcall
+  #endif
+  #define PREF3(x) x
+  #endif
+  #define PREF4 __stdcall
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+
+typedef enum enPL1000Inputs
+{
+  PL1000_CHANNEL_1 = 1,
+  PL1000_CHANNEL_2,
+  PL1000_CHANNEL_3,
+  PL1000_CHANNEL_4,
+  PL1000_CHANNEL_5,
+  PL1000_CHANNEL_6,
+  PL1000_CHANNEL_7,
+  PL1000_CHANNEL_8,
+  PL1000_CHANNEL_9,
+  PL1000_CHANNEL_10,
+  PL1000_CHANNEL_11,
+	PL1000_CHANNEL_12,
+	PL1000_CHANNEL_13,
+	PL1000_CHANNEL_14,
+	PL1000_CHANNEL_15,
+	PL1000_CHANNEL_16,
+	PL1000_MAX_CHANNELS = PL1000_CHANNEL_16
+} PL1000_INPUTS;
+
+typedef enum enPL1000DO_Channel
+{
+	PL1000_DO_CHANNEL_0,
+	PL1000_DO_CHANNEL_1,
+	PL1000_DO_CHANNEL_2,
+	PL1000_DO_CHANNEL_3,
+	PL1000_DO_CHANNEL_MAX
+} PL1000_DO_CH;
+
+typedef enum enPL1000OpenProgress
+{
+  PL1000_OPEN_PROGRESS_FAIL     = -1,
+  PL1000_OPEN_PROGRESS_PENDING  = 0,
+  PL1000_OPEN_PROGRESS_COMPLETE = 1
+} PL1000_OPEN_PROGRESS;
+
+#define PL1000_MIN_PERIOD 100
+#define PL1000_MAX_PERIOD 1800
+
+
+#ifndef BM_DEFINED
+#define BM_DEFINED
+typedef enum _BLOCK_METHOD{BM_SINGLE, BM_WINDOW, BM_STREAM} BLOCK_METHOD;
+#endif
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000OpenUnit) (int16_t * handle);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000CloseUnit) (int16_t handle);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000GetUnitInfo)
+	(int16_t handle, int8_t * string, int16_t stringLength, int16_t * requiredSize, PICO_INFO info);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000SetDo) (int16_t handle, int16_t do_value, int16_t doNo);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000SetPulseWidth) (int16_t handle, uint16_t period, uint8_t cycle);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000Run) (int16_t handle, uint32_t no_of_values, BLOCK_METHOD method);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000Ready) (int16_t handle, int16_t * ready);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000Stop) (int16_t handle);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000MaxValue) (int16_t handle, uint16_t *maxValue);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000SetInterval)
+	(int16_t handle, uint32_t * us_for_block, uint32_t ideal_no_of_samples, int16_t * channels,int16_t no_of_channels);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000SetTrigger)
+	(int16_t handle, uint16_t enabled, uint16_t auto_trigger, uint16_t auto_ms, uint16_t channel, uint16_t dir, uint16_t threshold, uint16_t hysterisis, float delay);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000GetValues)
+	(int16_t handle, uint16_t * values, uint32_t * noOfValues, uint16_t * overflow, uint32_t * triggerIndex);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000GetTriggerTimeOffsetNs)	(int16_t handle, int64_t * time);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000GetSingle) (int16_t handle, PL1000_INPUTS channel, uint16_t *value);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000OpenUnitAsync) (int16_t * status);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000OpenUnitProgress) (int16_t * handle, int16_t * progress, int16_t * complete);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000PingUnit) (int16_t handle);
+
+#endif

+ 168 - 0
pico-tcp-service/pico-tcp-client/inc/plcm3Api.h

@@ -0,0 +1,168 @@
+/**************************************************************************
+*
+* Filename:    plcm3Api.h
+* Author:      MAS
+* Description:
+*
+* This header defines the interface to driver routines for the
+* PicoLog CM3 Data Logger.
+*
+* Copyright © 2011-2018 Pico Technology Ltd. All rights reserved.
+*
+*************************************************************************/
+#ifndef __PLCM3API_H__
+#define __PLCM3API_H__
+
+#include <stdint.h>
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+  //	If you are dynamically linking plcm3.dll into your project #define DYNLINK
+  //  somewhere in your project before here.
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+#else
+/* Define a 64-bit integer type */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+#endif
+
+#define PLCM3_MIN_WIRES 2
+#define PLCM3_MAX_WIRES 4
+
+typedef enum enPLCM3Channels
+{
+  PLCM3_CHANNEL_1 = 1,
+  PLCM3_CHANNEL_2,
+  PLCM3_CHANNEL_3,
+  PLCM3_MAX_CHANNELS = PLCM3_CHANNEL_3
+} PLCM3_CHANNELS;
+
+typedef enum enPLCM3DataType
+{
+  PLCM3_OFF,
+  PLCM3_1_MILLIVOLT,
+  PLCM3_10_MILLIVOLTS,
+  PLCM3_100_MILLIVOLTS,
+  PLCM3_VOLTAGE,
+PLCM3_MAX_DATA_TYPES
+} PLCM3_DATA_TYPES;
+
+typedef enum enPLCM3IpDetailsType
+{
+  PLCM3_IDT_GET,
+  PLCM3_IDT_SET,
+} PLCM3_IP_DETAILS_TYPE;
+
+typedef enum enPLCM3CommunicationType
+{
+  PLCM3_CT_USB = 0x00000001,
+  PLCM3_CT_ETHERNET = 0x00000002,
+  PLCM3_CT_ALL = 0xFFFFFFFF
+}PLCM3_COMMUNICATION_TYPE;
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3Enumerate)
+(
+  int8_t   *details,
+  uint32_t *length,
+  PLCM3_COMMUNICATION_TYPE type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (PLCM3OpenUnit)
+(
+  int16_t * handle,
+  int8_t  * serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3OpenUnitViaIp)
+(
+  int16_t * handle,
+  int8_t  * serial,
+  int8_t  * ipAddress
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3CloseUnit)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3IpDetails)
+(
+  int16_t   handle,
+  int16_t  *enabled,
+  int8_t   *ipaddress,
+  uint16_t *length,
+  uint16_t *listeningPort,
+  PLCM3_IP_DETAILS_TYPE type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3GetUnitInfo)
+(
+  int16_t handle,
+  int8_t * string,
+  int16_t stringLength,
+  int16_t * requiredSize,
+  PICO_INFO info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3SetChannel)
+(
+  int16_t handle,
+  PLCM3_CHANNELS channel,
+  PLCM3_DATA_TYPES type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3SetMains)
+(
+  int16_t handle,
+  uint16_t sixtyHertz
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3GetValue)
+(
+  int16_t handle,
+  PLCM3_CHANNELS channel,
+  int32_t * value
+);
+#endif

+ 607 - 0
pico-tcp-service/pico-tcp-client/inc/ps2000.h

@@ -0,0 +1,607 @@
+/****************************************************************************
+ *
+ * Filename:    ps2000.h
+ * Author:      MTB & MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 2000 Series PC Oscilloscopes.
+ *
+ * Copyright � 2005 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef PS2000_H
+#define PS2000_H
+
+#include <stdint.h>
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+#ifdef PREF4
+  #undef PREF4
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+/*  If you are dynamically linking ps2000.dll into your project #define DYNLINK here
+ */
+#ifdef WIN32
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+  #define PREF4 __stdcall
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+#define PS2000_FIRST_USB  1
+#define PS2000_LAST_USB   127
+
+/* Maximum number of PS2000 units that can be opened at once
+ */
+#define PS2000_MAX_UNITS (PS2000_LAST_USB - PS2000_FIRST_USB + 1)
+
+#define PS2000_MAX_TIMEBASE  19
+
+#define PS2105_MAX_TIMEBASE 20
+#define PS2104_MAX_TIMEBASE 19
+
+#define PS2200_MAX_TIMEBASE 23
+
+#define PS2000_MAX_OVERSAMPLE 256
+
+#define PS2105_MAX_ETS_CYCLES  250
+#define PS2105_MAX_ETS_INTERLEAVE  50
+
+#define PS2104_MAX_ETS_CYCLES  125
+#define PS2104_MAX_ETS_INTERLEAVE  25
+
+#define PS2203_MAX_ETS_CYCLES  250
+#define PS2203_MAX_ETS_INTERLEAVE 50
+
+#define PS2204_MAX_ETS_CYCLES  250
+#define PS2204_MAX_ETS_INTERLEAVE 40
+
+#define PS2205_MAX_ETS_CYCLES  250
+#define PS2205_MAX_ETS_INTERLEAVE 40
+
+#define PS2000_MIN_ETS_CYCLES_INTERLEAVE_RATIO 1
+#define PS2000_MAX_ETS_CYCLES_INTERLEAVE_RATIO  10
+
+#define PS2000_MIN_SIGGEN_FREQ 0.0f
+#define PS2000_MAX_SIGGEN_FREQ 100000.0f
+
+
+/* Although the PS2000 uses an 8-bit ADC, it is usually possible to
+ * oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+
+#define PS2000_MAX_VALUE 32767
+#define PS2000_MIN_VALUE -32767
+#define PS2000_LOST_DATA -32768
+
+typedef enum enPS2000Channel
+{
+  PS2000_CHANNEL_A,
+  PS2000_CHANNEL_B,
+  PS2000_CHANNEL_C,
+  PS2000_CHANNEL_D,
+  PS2000_EXTERNAL,
+  PS2000_MAX_CHANNELS = PS2000_EXTERNAL,
+  PS2000_NONE,
+}  PS2000_CHANNEL;
+
+typedef enum enPS2000Range
+{
+  PS2000_10MV,
+  PS2000_20MV,
+  PS2000_50MV,
+  PS2000_100MV,
+  PS2000_200MV,
+  PS2000_500MV,
+  PS2000_1V,
+  PS2000_2V,
+  PS2000_5V,
+  PS2000_10V,
+  PS2000_20V,
+  PS2000_50V,
+  PS2000_MAX_RANGES
+}  PS2000_RANGE;
+
+typedef enum enPS2000TimeUnits
+  {
+  PS2000_FS,
+  PS2000_PS,
+  PS2000_NS,
+  PS2000_US,
+  PS2000_MS,
+  PS2000_S,
+  PS2000_MAX_TIME_UNITS,
+  }  PS2000_TIME_UNITS;
+
+typedef enum enPS2000Error
+  {
+  PS2000_OK,
+  PS2000_MAX_UNITS_OPENED,  // more than PS2000_MAX_UNITS
+  PS2000_MEM_FAIL,          //not enough RAM on host machine
+  PS2000_NOT_FOUND,         //cannot find device
+  PS2000_FW_FAIL,           //unabled to download firmware
+  PS2000_NOT_RESPONDING,
+  PS2000_CONFIG_FAIL,       //missing or corrupted configuration settings
+  PS2000_OS_NOT_SUPPORTED,  //need to use win98SE (or later) or win2k (or later)
+  PS2000_PICOPP_TOO_OLD,
+  }  PS2000_ERROR;
+
+typedef enum enPS2000Info
+{
+  PS2000_DRIVER_VERSION,
+  PS2000_USB_VERSION,
+  PS2000_HARDWARE_VERSION,
+  PS2000_VARIANT_INFO,
+  PS2000_BATCH_AND_SERIAL,
+  PS2000_CAL_DATE,
+  PS2000_ERROR_CODE,
+  PS2000_KERNEL_DRIVER_VERSION,
+  PS2000_DRIVER_PATH
+}  PS2000_INFO;
+
+typedef enum enPS2000TriggerDirection
+  {
+  PS2000_RISING,
+  PS2000_FALLING,
+  PS2000_MAX_DIRS
+  }  PS2000_TDIR;
+
+typedef enum enPS2000OpenProgress
+  {
+  PS2000_OPEN_PROGRESS_FAIL     = -1,
+  PS2000_OPEN_PROGRESS_PENDING  =  0,
+  PS2000_OPEN_PROGRESS_COMPLETE =  1
+  } PS2000_OPEN_PROGRESS;
+
+typedef enum enPS2000EtsMode
+  {
+  PS2000_ETS_OFF,   // ETS disabled
+  PS2000_ETS_FAST,  // Return ready as soon as requested no of interleaves is available
+  PS2000_ETS_SLOW,  // Return ready every time a new set of no_of_cycles is collected
+  PS2000_ETS_MODES_MAX
+  }  PS2000_ETS_MODE;
+
+typedef enum enPS2000ButtonState
+  {
+  PS2000_NO_PRESS,
+  PS2000_SHORT_PRESS,
+  PS2000_LONG_PRESS
+  } PS2000_BUTTON_STATE;
+
+typedef enum enPS2000SweepType
+{
+  PS2000_UP,
+  PS2000_DOWN,
+  PS2000_UPDOWN,
+  PS2000_DOWNUP,
+  MAX_SWEEP_TYPES
+} PS2000_SWEEP_TYPE;
+
+typedef enum enPS2000WaveType
+{
+  PS2000_SINE,
+  PS2000_SQUARE,
+  PS2000_TRIANGLE,
+  PS2000_RAMPUP,
+  PS2000_RAMPDOWN,
+  PS2000_DC_VOLTAGE,
+  PS2000_GAUSSIAN,
+  PS2000_SINC,
+  PS2000_HALF_SINE,
+} PS2000_WAVE_TYPE;
+
+typedef void (PREF4 *GetOverviewBuffersMaxMin)
+(
+  int16_t **overviewBuffers,
+  int16_t   overflow,
+  uint32_t  triggeredAt,
+  int16_t   triggered,
+  int16_t   auto_stop,
+  uint32_t  nValues
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_open_unit)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_get_unit_info)
+(
+  int16_t  handle,
+  int8_t  *string,
+  int16_t  string_length,
+  int16_t  line
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_flash_led)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_close_unit)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_channel)
+(
+  int16_t  handle,
+  int16_t  channel,
+  int16_t  enabled,
+  int16_t  dc,
+  int16_t  range
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_get_timebase)
+(
+  int16_t  handle,
+  int16_t  timebase,
+  int32_t  no_of_samples,
+  int32_t *time_interval,
+  int16_t *time_units,
+  int16_t  oversample,
+  int32_t *max_samples
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_trigger)
+(
+  int16_t  handle,
+  int16_t  source,
+  int16_t  threshold,
+  int16_t  direction,
+  int16_t  delay,
+  int16_t  auto_trigger_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_trigger2)
+(
+  int16_t  handle,
+  int16_t  source,
+  int16_t  threshold,
+  int16_t  direction,
+  float    delay,
+  int16_t  auto_trigger_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_run_block)
+(
+  int16_t handle,
+  int32_t  no_of_values,
+  int16_t  timebase,
+  int16_t  oversample,
+  int32_t * time_indisposed_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_run_streaming)
+(
+  int16_t  handle,
+  int16_t  sample_interval_ms,
+  int32_t  max_samples,
+  int16_t  windowed
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_run_streaming_ns)
+(
+  int16_t            handle,
+  uint32_t           sample_interval,
+  PS2000_TIME_UNITS  time_units,
+  uint32_t           max_samples,
+  int16_t            auto_stop,
+  uint32_t           noOfSamplesPerAggregate,
+  uint32_t           overview_buffer_size);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_ready)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_stop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps2000_get_values)
+(
+  int16_t  handle,
+  int16_t *buffer_a,
+  int16_t *buffer_b,
+  int16_t *buffer_c,
+  int16_t *buffer_d,
+  int16_t *overflow,
+  int32_t  no_of_values
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps2000_get_times_and_values)
+(
+  int16_t  handle,
+  int32_t *times,
+  int16_t *buffer_a,
+  int16_t *buffer_b,
+  int16_t *buffer_c,
+  int16_t *buffer_d,
+  int16_t *overflow,
+  int16_t  time_units,
+  int32_t  no_of_values
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_last_button_press)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps2000_set_ets)
+(
+  int16_t  handle,
+  int16_t  mode,
+  int16_t  ets_cycles,
+  int16_t  ets_interleave
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_led)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_open_unit_async)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_open_unit_progress)
+(
+  int16_t *handle,
+  int16_t *progress_percent
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000_get_streaming_last_values)
+(
+  int16_t  handle,
+  GetOverviewBuffersMaxMin
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000_overview_buffer_status)
+(
+  int16_t  handle,
+  int16_t *previous_buffer_overrun
+);
+
+PREF0 PREF1 uint32_t PREF2 PREF3 (ps2000_get_streaming_values)
+(
+  int16_t  handle,
+  double   *start_time,
+  int16_t  *pbuffer_a_max,
+  int16_t  *pbuffer_a_min,
+  int16_t  *pbuffer_b_max,
+  int16_t  *pbuffer_b_min,
+  int16_t  *pbuffer_c_max,
+  int16_t  *pbuffer_c_min,
+  int16_t  *pbuffer_d_max,
+  int16_t  *pbuffer_d_min,
+  int16_t  *overflow,
+  uint32_t *triggerAt,
+  int16_t  *triggered,
+  uint32_t  no_of_values,
+  uint32_t  noOfSamplesPerAggregate
+);
+
+PREF0 PREF1 uint32_t PREF2 PREF3 (ps2000_get_streaming_values_no_aggregation)
+(
+  int16_t handle,
+  double *start_time,
+  int16_t * pbuffer_a,
+  int16_t * pbuffer_b,
+  int16_t * pbuffer_c,
+  int16_t * pbuffer_d,
+  int16_t * overflow,
+  uint32_t * triggerAt,
+  int16_t * trigger,
+  uint32_t no_of_values
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_light)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_sig_gen_arbitrary)
+ (
+  int16_t            handle,
+  int32_t            offsetVoltage,
+  uint32_t           pkToPk,
+  uint32_t           startDeltaPhase,
+  uint32_t           stopDeltaPhase,
+  uint32_t           deltaPhaseIncrement,
+  uint32_t           dwellCount,
+  uint8_t           *arbitraryWaveform,
+  int32_t            arbitraryWaveformSize,
+  PS2000_SWEEP_TYPE  sweepType,
+  uint32_t           sweeps
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_sig_gen_built_in)
+(
+  int16_t            handle,
+  int32_t            offsetVoltage,
+  uint32_t           pkToPk,
+  PS2000_WAVE_TYPE   waveType,
+  float              startFrequency,
+  float              stopFrequency,
+  float              increment,
+  float              dwellTime,
+  PS2000_SWEEP_TYPE  sweepType,
+  uint32_t           sweeps
+);
+
+//===========================================================
+// Adv Trigger
+//===========================================================
+typedef enum enPS2000ThresholdDirection
+{
+  PS2000_ABOVE,
+  PS2000_BELOW,
+  PS2000_ADV_RISING,
+  PS2000_ADV_FALLING,
+  PS2000_RISING_OR_FALLING,
+  PS2000_INSIDE = PS2000_ABOVE,
+  PS2000_OUTSIDE = PS2000_BELOW,
+  PS2000_ENTER = PS2000_ADV_RISING,
+  PS2000_EXIT = PS2000_ADV_FALLING,
+  PS2000_ENTER_OR_EXIT = PS2000_RISING_OR_FALLING,
+  PS2000_ADV_NONE = PS2000_ADV_RISING
+} PS2000_THRESHOLD_DIRECTION;
+
+typedef enum enPS2000ThresholdMode
+{
+  PS2000_LEVEL,
+  PS2000_WINDOW
+} PS2000_THRESHOLD_MODE;
+
+typedef enum enPS2000TriggerState
+{
+  PS2000_CONDITION_DONT_CARE,
+  PS2000_CONDITION_TRUE,
+  PS2000_CONDITION_FALSE,
+  PS2000_CONDITION_MAX
+} PS2000_TRIGGER_STATE;
+
+typedef enum enPS2000PulseWidthType
+{
+  PS2000_PW_TYPE_NONE,
+  PS2000_PW_TYPE_LESS_THAN,
+  PS2000_PW_TYPE_GREATER_THAN,
+  PS2000_PW_TYPE_IN_RANGE,
+  PS2000_PW_TYPE_OUT_OF_RANGE
+} PS2000_PULSE_WIDTH_TYPE;
+
+#pragma pack(1)
+typedef struct tPS2000TriggerChannelProperties
+{
+  int16_t thresholdMajor;
+  int16_t thresholdMinor;
+  uint16_t hysteresis;
+  int16_t channel;
+  PS2000_THRESHOLD_MODE thresholdMode;
+} PS2000_TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tPS2000TriggerConditions
+{
+  PS2000_TRIGGER_STATE channelA;
+  PS2000_TRIGGER_STATE channelB;
+  PS2000_TRIGGER_STATE channelC;
+  PS2000_TRIGGER_STATE channelD;
+  PS2000_TRIGGER_STATE external;
+  PS2000_TRIGGER_STATE pulseWidthQualifier;
+} PS2000_TRIGGER_CONDITIONS;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tPS2000PwqConditions
+{
+  PS2000_TRIGGER_STATE channelA;
+  PS2000_TRIGGER_STATE channelB;
+  PS2000_TRIGGER_STATE channelC;
+  PS2000_TRIGGER_STATE channelD;
+  PS2000_TRIGGER_STATE external;
+} PS2000_PWQ_CONDITIONS;
+#pragma pack()
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000SetAdvTriggerChannelProperties)
+(
+  int16_t                            handle,
+  PS2000_TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                            nChannelProperties,
+  int32_t                            autoTriggerMilliseconds
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000SetAdvTriggerChannelConditions)
+(
+  int16_t                    handle,
+  PS2000_TRIGGER_CONDITIONS *conditions,
+  int16_t                    nConditions
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000SetAdvTriggerChannelDirections)
+(
+  int16_t                     handle,
+  PS2000_THRESHOLD_DIRECTION  channelA,
+  PS2000_THRESHOLD_DIRECTION  channelB,
+  PS2000_THRESHOLD_DIRECTION  channelC,
+  PS2000_THRESHOLD_DIRECTION  channelD,
+  PS2000_THRESHOLD_DIRECTION  ext
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000SetPulseWidthQualifier)
+(
+  int16_t                     handle,
+  PS2000_PWQ_CONDITIONS      *conditions,
+  int16_t                     nConditions,
+  PS2000_THRESHOLD_DIRECTION  direction,
+  uint32_t                    lower,
+  uint32_t                    upper,
+  PS2000_PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000SetAdvTriggerDelay)
+(
+  int16_t   handle,
+  uint32_t  delay,
+  float     preTriggerDelay
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000PingUnit)
+(
+  int16_t  handle
+);
+
+#endif /* not defined PS2000_H */

+ 2948 - 0
pico-tcp-service/pico-tcp-client/inc/ps2000aApi.h

@@ -0,0 +1,2948 @@
+/****************************************************************************
+ *
+ * Filename:    ps2000aApi.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *	PicoScope 2000A and 2000B Series, and 2205 MSO PC Oscilloscopes.
+ *
+ * Copyright � 2010 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS2000AAPI_H__
+#define __PS2000AAPI_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#ifdef __cplusplus
+	#define PREF0 extern "C"
+	#define TYPE_ENUM
+#else
+	#define PREF0
+	#define TYPE_ENUM enum
+#endif
+
+#ifdef WIN32
+	#ifdef PREF1
+	  #undef PREF1
+	#endif
+	#ifdef PREF2
+	  #undef PREF2
+	#endif
+	#ifdef PREF3
+	  #undef PREF3
+	#endif
+	/*	If you are dynamically linking ps2000a.dll into your project #define DYNLINK here
+	 */
+	#ifdef DYNLINK
+	  #define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (__stdcall *x)
+	#else
+	  #define PREF1
+		#ifdef _USRDLL
+			#define PREF2 __declspec(dllexport) __stdcall
+		#else
+			#define PREF2 __declspec(dllimport) __stdcall
+		#endif
+	  #define PREF3(x) x
+	#endif
+#else
+	/* Define a 64-bit integer type */
+
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+	#define __stdcall
+#endif
+
+/* Depending on the adc; oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+
+// covers the PS2208 and PS2208A
+#define PS2208_MAX_ETS_CYCLES	500
+#define PS2208_MAX_INTERLEAVE	 20
+
+// covers the PS2207 and PS2207A
+#define PS2207_MAX_ETS_CYCLES	500
+#define PS2207_MAX_INTERLEAVE	 20
+
+// covers the PS2206 and PS2206A
+#define PS2206_MAX_ETS_CYCLES	250
+#define PS2206_MAX_INTERLEAVE	 10
+
+#define PS2000A_EXT_MAX_VALUE  32767
+#define PS2000A_EXT_MIN_VALUE -32767
+
+#define PS2000A_MAX_LOGIC_LEVEL	 32767
+#define PS2000A_MIN_LOGIC_LEVEL -32767
+
+#define MIN_SIG_GEN_FREQ 0.0f
+#define MAX_SIG_GEN_FREQ 20000000.0f
+
+#define PS2000A_MAX_SIG_GEN_BUFFER_SIZE 8192
+#define PS2000A_MIN_SIG_GEN_BUFFER_SIZE 1
+#define PS2000A_MIN_DWELL_COUNT				3
+#define PS2000A_MAX_SWEEPS_SHOTS				((1 << 30) - 1)
+
+#define PS2000A_MAX_ANALOGUE_OFFSET_50MV_200MV	 0.250f
+#define PS2000A_MIN_ANALOGUE_OFFSET_50MV_200MV	-0.250f
+#define PS2000A_MAX_ANALOGUE_OFFSET_500MV_2V		 2.500f
+#define PS2000A_MIN_ANALOGUE_OFFSET_500MV_2V		-2.500f
+#define PS2000A_MAX_ANALOGUE_OFFSET_5V_20V			 20.f
+#define PS2000A_MIN_ANALOGUE_OFFSET_5V_20V			-20.f
+
+// supported by the PS2206/PS2206A, PS2207/PS2207A, PS2208/PS2208A only
+#define PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN 0xFFFFFFFF
+
+/// <summary>
+/// The analogue channels index
+/// </summary>
+typedef enum enPS2000AChannelBufferIndex
+{
+	PS2000A_CHANNEL_A_MAX,
+	PS2000A_CHANNEL_A_MIN,
+	PS2000A_CHANNEL_B_MAX,
+	PS2000A_CHANNEL_B_MIN,
+	PS2000A_CHANNEL_C_MAX,
+	PS2000A_CHANNEL_C_MIN,
+	PS2000A_CHANNEL_D_MAX,
+	PS2000A_CHANNEL_D_MIN,
+	PS2000A_MAX_CHANNEL_BUFFERS
+} PS2000A_CHANNEL_BUFFER_INDEX;
+
+/// <summary>
+/// The analogue channels and trigger channels supported by the devices
+/// </summary>
+typedef enum enPS2000AChannel
+{
+	PS2000A_CHANNEL_A,
+	PS2000A_CHANNEL_B,
+	PS2000A_CHANNEL_C,
+	PS2000A_CHANNEL_D,
+	PS2000A_EXTERNAL,
+	PS2000A_MAX_CHANNELS = PS2000A_EXTERNAL,
+	PS2000A_TRIGGER_AUX,
+	PS2000A_MAX_TRIGGER_SOURCES
+
+}	PS2000A_CHANNEL;
+
+/// <summary>
+/// MSO models only.
+/// Defines how the analgoue and digital triggers are combined.
+/// </summary>
+
+typedef enum enPS2000ATriggerOperand
+{
+	/// <summary>
+	/// Ignore the trigger settings
+	/// </summary>
+	PS2000A_OPERAND_NONE,
+	/// <summary>
+	/// Fire when either trigger is activated.
+	/// </summary>
+	PS2000A_OPERAND_OR,
+	/// <summary>
+	/// Fire when both triggers are activated
+	/// </summary>
+	PS2000A_OPERAND_AND,
+	/// <summary>
+	/// Fire when one trigger is activated.
+	/// </summary>
+	PS2000A_OPERAND_THEN
+} PS2000A_TRIGGER_OPERAND;
+
+/// <summary>
+/// MSO ports
+/// </summary>
+typedef enum enPS2000DigitalPort
+{
+	PS2000A_DIGITAL_PORT0 = 0x80, // digital channel 0 - 7
+	PS2000A_DIGITAL_PORT1,			 // digital channel 8 - 15
+	PS2000A_DIGITAL_PORT2,			 // digital channel 16 - 23
+	PS2000A_DIGITAL_PORT3,			 // digital channel 24 - 31
+	PS2000A_MAX_DIGITAL_PORTS = (PS2000A_DIGITAL_PORT3 - PS2000A_DIGITAL_PORT0) + 1
+}	PS2000A_DIGITAL_PORT;
+
+
+/// <summary>
+/// MSO digital channels
+/// </summary>
+typedef enum enPS2000ADigitalChannel
+{
+	PS2000A_DIGITAL_CHANNEL_0,
+	PS2000A_DIGITAL_CHANNEL_1,
+	PS2000A_DIGITAL_CHANNEL_2,
+	PS2000A_DIGITAL_CHANNEL_3,
+	PS2000A_DIGITAL_CHANNEL_4,
+	PS2000A_DIGITAL_CHANNEL_5,
+	PS2000A_DIGITAL_CHANNEL_6,
+	PS2000A_DIGITAL_CHANNEL_7,
+	PS2000A_DIGITAL_CHANNEL_8,
+	PS2000A_DIGITAL_CHANNEL_9,
+	PS2000A_DIGITAL_CHANNEL_10,
+	PS2000A_DIGITAL_CHANNEL_11,
+	PS2000A_DIGITAL_CHANNEL_12,
+	PS2000A_DIGITAL_CHANNEL_13,
+	PS2000A_DIGITAL_CHANNEL_14,
+	PS2000A_DIGITAL_CHANNEL_15,
+	PS2000A_DIGITAL_CHANNEL_16,
+	PS2000A_DIGITAL_CHANNEL_17,
+	PS2000A_DIGITAL_CHANNEL_18,
+	PS2000A_DIGITAL_CHANNEL_19,
+	PS2000A_DIGITAL_CHANNEL_20,
+	PS2000A_DIGITAL_CHANNEL_21,
+	PS2000A_DIGITAL_CHANNEL_22,
+	PS2000A_DIGITAL_CHANNEL_23,
+	PS2000A_DIGITAL_CHANNEL_24,
+	PS2000A_DIGITAL_CHANNEL_25,
+	PS2000A_DIGITAL_CHANNEL_26,
+	PS2000A_DIGITAL_CHANNEL_27,
+	PS2000A_DIGITAL_CHANNEL_28,
+	PS2000A_DIGITAL_CHANNEL_29,
+	PS2000A_DIGITAL_CHANNEL_30,
+	PS2000A_DIGITAL_CHANNEL_31,
+	PS2000A_MAX_DIGITAL_CHANNELS
+} PS2000A_DIGITAL_CHANNEL;
+
+/// <summary>
+/// Ranges that the channels are set to:
+/// Not all ranges are supported by every variant
+/// </summary>
+typedef enum enPS2000ARange
+{
+	PS2000A_10MV,
+	PS2000A_20MV,
+	PS2000A_50MV,
+	PS2000A_100MV,
+	PS2000A_200MV,
+	PS2000A_500MV,
+	PS2000A_1V,
+	PS2000A_2V,
+	PS2000A_5V,
+	PS2000A_10V,
+	PS2000A_20V,
+	PS2000A_50V,
+	PS2000A_MAX_RANGES,
+} PS2000A_RANGE;
+
+/// <summary>
+/// Available coupling modes.
+/// </summary>
+typedef enum enPS2000ACoupling
+{
+	PS2000A_AC,
+	PS2000A_DC
+} PS2000A_COUPLING;
+
+typedef enum enPS2000AChannelInfo
+{
+	PS2000A_CI_RANGES,
+} PS2000A_CHANNEL_INFO;
+
+/// <summary>
+/// Ets modes avialable
+/// </summary>
+typedef enum enPS2000AEtsMode
+{
+	/// <summary>
+	/// disables
+	/// </summary>
+  PS2000A_ETS_OFF,
+	/// <summary>
+	/// enables ETS and provides etsCycles of data, which may contain data from previously returned cycles.
+	/// </summary>
+  PS2000A_ETS_FAST,
+	/// <summary>
+	/// enables ETS and provides fresh data every etsCycles. This
+	/// mode takes longer to provide each data set, but the data sets are more stable and
+	/// are guaranteed to contain only new data.
+	/// </summary>
+	PS2000A_ETS_SLOW,
+
+  PS2000A_ETS_MODES_MAX
+  }	PS2000A_ETS_MODE;
+
+/// <summary>
+/// Time units that the time paramaters are using.
+/// </summary>
+typedef enum enPS2000ATimeUnits
+  {
+  PS2000A_FS,
+  PS2000A_PS,
+  PS2000A_NS,
+  PS2000A_US,
+  PS2000A_MS,
+  PS2000A_S,
+  PS2000A_MAX_TIME_UNITS,
+  }	PS2000A_TIME_UNITS;
+
+/// <summary>
+/// whether the frequency will sweep from startFrequency to
+/// stopFrequency, or in the opposite direction, or repeatedly reverse direction
+/// </summary>
+typedef enum enPS2000ASweepType
+{
+	PS2000A_UP,
+	PS2000A_DOWN,
+	PS2000A_UPDOWN,
+	PS2000A_DOWNUP,
+	PS2000A_MAX_SWEEP_TYPES
+} PS2000A_SWEEP_TYPE;
+
+/// <summary>
+/// Built in waveform types
+/// </summary>
+typedef enum enPS2000AWaveType
+{
+	PS2000A_SINE,
+	PS2000A_SQUARE,
+	PS2000A_TRIANGLE,
+	PS2000A_RAMP_UP,
+	PS2000A_RAMP_DOWN,
+	PS2000A_SINC,
+	PS2000A_GAUSSIAN,
+	PS2000A_HALF_SINE,
+	PS2000A_DC_VOLTAGE,
+	PS2000A_MAX_WAVE_TYPES
+} PS2000A_WAVE_TYPE;
+
+/// <summary>
+/// The type of waveform to be produced, specified by one of the following
+/// </summary>
+typedef enum enPS2000AExtraOperations
+{
+	/// <summary>
+	/// Normal signal generator operation specified by wavetype.
+	/// </summary>
+	PS2000A_ES_OFF,
+	/// <summary>
+	/// The signal generator produces white noise and ignores all settings except pkToPk and offsetVoltage.
+	/// </summary>
+	PS2000A_WHITENOISE,
+	/// <summary>
+	/// produces a pseudorandom random binary sequence with a bit rate
+	/// specified by the start and stop frequency.
+	/// </summary>
+	PS2000A_PRBS // Pseudo-Random Bit Stream
+} PS2000A_EXTRA_OPERATIONS;
+
+
+#define PS2000A_SINE_MAX_FREQUENCY				1000000.f
+#define PS2000A_SQUARE_MAX_FREQUENCY			1000000.f
+#define PS2000A_TRIANGLE_MAX_FREQUENCY		1000000.f
+#define PS2000A_SINC_MAX_FREQUENCY				1000000.f
+#define PS2000A_RAMP_MAX_FREQUENCY				1000000.f
+#define PS2000A_HALF_SINE_MAX_FREQUENCY		1000000.f
+#define PS2000A_GAUSSIAN_MAX_FREQUENCY		1000000.f
+#define PS2000A_PRBS_MAX_FREQUENCY				1000000.f
+#define PS2000A_PRBS_MIN_FREQUENCY					 0.03f
+#define PS2000A_MIN_FREQUENCY			  				 0.03f
+
+/// <summary>
+/// The type of trigger that will be applied to the signal generator
+/// </summary>
+typedef enum enPS2000ASigGenTrigType
+{
+	/// <summary>
+	/// Trigger on rising edge
+	/// </summary>
+	PS2000A_SIGGEN_RISING,
+	/// <summary>
+	/// Trigger on falling edge
+	/// </summary>
+	PS2000A_SIGGEN_FALLING,
+	/// <summary>
+	/// Run while trigger is high
+	/// </summary>
+	PS2000A_SIGGEN_GATE_HIGH,
+	/// <summary>
+	/// Run while trigger is low
+	/// </summary>
+	PS2000A_SIGGEN_GATE_LOW
+} PS2000A_SIGGEN_TRIG_TYPE;
+
+/// <summary>
+/// The source that will trigger the signal generator
+/// </summary>
+typedef enum enPS2000ASigGenTrigSource
+{
+	/// <summary>
+	/// Run without waiting for trigger
+	/// </summary>
+	PS2000A_SIGGEN_NONE,
+	/// <summary>
+	/// Use scope trigger
+	/// </summary
+	PS2000A_SIGGEN_SCOPE_TRIG,
+	/// <summary>
+	/// Use AUXIO input
+	/// </summary>
+	PS2000A_SIGGEN_AUX_IN,
+	/// <summary>
+	/// Use external input
+	/// </summary>
+	PS2000A_SIGGEN_EXT_IN,
+	/// <summary>
+	/// Wait for software trigger
+	/// </summary>
+	PS2000A_SIGGEN_SOFT_TRIG
+} PS2000A_SIGGEN_TRIG_SOURCE;
+
+/// <summary>
+/// AWG index modes
+/// </summary>
+typedef enum enPS2000AIndexMode
+{
+	/// <summary>
+	/// The generator outputs the raw contents of the buffer repeatedly .
+	/// </summary>
+	PS2000A_SINGLE,
+	/// <summary>
+	/// The generator outputs the contents of the buffer from beginning to end, and then does a second pass in the reverse
+	/// direction through the buffer
+	/// </summary>
+	PS2000A_DUAL,
+	/// <summary>
+	/// This is similiar to the Dual but passes through the buffer four time inverting, and inverting reversed
+	/// </summary>
+	PS2000A_QUAD,
+
+	PS2000A_MAX_INDEX_MODES
+} PS2000A_INDEX_MODE;
+
+/// <summary>
+/// The number of thershold that will be used for triggering.
+/// </summary>
+typedef enum enPS2000A_ThresholdMode
+{
+	PS2000A_LEVEL,
+	PS2000A_WINDOW
+} PS2000A_THRESHOLD_MODE;
+
+/// <summary>
+/// The direction that the signal will pass through the trigger.
+/// </summary>
+typedef enum enPS2000AThresholdDirection
+{
+	/// <summary>
+	/// For gated triggers: above the upper threshold.
+	/// </summary>
+	PS2000A_ABOVE,
+	/// <summary>
+	/// For gated triggers: below the upper threshold.
+	/// </summary
+	PS2000A_BELOW,
+	/// <summary>
+	/// For threshold triggers: rising edge, using upper threshold.
+	/// </summary>
+	PS2000A_RISING,
+	/// <summary>
+	/// For threshold triggers: falling edge, using upper threshold.
+	/// </summary>
+	PS2000A_FALLING,
+	/// <summary>
+	/// For threshold triggers: either edge.
+	/// </summary>
+	PS2000A_RISING_OR_FALLING,
+	/// <summary>
+	/// For gated triggers: above the lower threshold.
+	/// </summary>
+	PS2000A_ABOVE_LOWER,
+	/// <summary>
+	/// For gated triggers: below the lower threshold.
+	/// </summary>
+	PS2000A_BELOW_LOWER,
+	/// <summary>
+	/// For threshold triggers: rising edge, using lower threshold.
+	/// </summary>
+	PS2000A_RISING_LOWER,
+	/// <summary>
+	/// For threshold triggers: falling edge, using lower threshold.
+	/// </summary>
+	PS2000A_FALLING_LOWER,
+
+	/// <summary>
+	/// For window-qualified triggers: inside window.
+	/// </summary>
+	PS2000A_INSIDE = PS2000A_ABOVE,
+	/// <summary>
+	/// For window-qualified triggers: outside window.
+	/// </summary>
+	PS2000A_OUTSIDE = PS2000A_BELOW,
+	/// <summary>
+	/// For window triggers: entering the window.
+	/// </summary>
+	PS2000A_ENTER = PS2000A_RISING,
+	/// <summary>
+  /// For window triggers: leaving the window.
+  /// </summary>
+	PS2000A_EXIT = PS2000A_FALLING,
+	/// <summary>
+	/// For window triggers: either entering or leaving the window.
+	/// </summary>
+	PS2000A_ENTER_OR_EXIT = PS2000A_RISING_OR_FALLING,
+	/// <summary>
+	/// For window-qualified triggers.
+	/// </summary>
+	PS2000A_POSITIVE_RUNT = 9,
+	/// <summary>
+	/// For window-qualified triggers.
+	/// </summary>
+  PS2000A_NEGATIVE_RUNT,
+
+	/// <summary>
+	/// No trigger.
+	/// </summary>
+  PS2000A_NONE = PS2000A_RISING
+} PS2000A_THRESHOLD_DIRECTION;
+
+
+/// <summary>
+/// Digital channel trigger dirction
+/// </summary>
+typedef enum enPS2000ADigitalDirection
+{
+	PS2000A_DIGITAL_DONT_CARE,
+	PS2000A_DIGITAL_DIRECTION_LOW,
+	PS2000A_DIGITAL_DIRECTION_HIGH,
+	PS2000A_DIGITAL_DIRECTION_RISING,
+	PS2000A_DIGITAL_DIRECTION_FALLING,
+	PS2000A_DIGITAL_DIRECTION_RISING_OR_FALLING,
+	PS2000A_DIGITAL_MAX_DIRECTION
+} PS2000A_DIGITAL_DIRECTION;
+
+/// <summary>
+/// The type of condition that should be applied to each channel.
+/// The channels that are set to True or False must all meet their conditions
+/// simultaneously to produce a trigger. Channels set to DontCare are ignored.
+/// </summary>
+typedef enum enPS2000ATriggerState
+{
+  PS2000A_CONDITION_DONT_CARE,
+  PS2000A_CONDITION_TRUE,
+  PS2000A_CONDITION_FALSE,
+	PS2000A_CONDITION_MAX
+} PS2000A_TRIGGER_STATE;
+
+/// <summary>
+/// A structure of this type is passed to ps2000aSetTriggerChannelConditions in the
+/// conditions argument to specify the trigger conditions.
+/// </summary>
+#pragma pack(push,1)
+typedef struct tPS2000ATriggerConditions
+{
+  PS2000A_TRIGGER_STATE channelA;
+  PS2000A_TRIGGER_STATE channelB;
+  PS2000A_TRIGGER_STATE channelC;
+  PS2000A_TRIGGER_STATE channelD;
+  PS2000A_TRIGGER_STATE external;
+  PS2000A_TRIGGER_STATE aux;
+	PS2000A_TRIGGER_STATE pulseWidthQualifier;
+	PS2000A_TRIGGER_STATE digital;
+} PS2000A_TRIGGER_CONDITIONS;
+#pragma pack(pop)
+
+
+/// <summary>
+/// A structure of this type is passed to ps2000aSetPulseWidthQualifier in the
+/// conditions argument to specify the trigger conditions.
+/// Analog-input models only ( for MSOs use PwqConditionsV2)
+/// </summary>
+#pragma pack(push,1)
+typedef struct tPS2000APwqConditions
+{
+  PS2000A_TRIGGER_STATE channelA;
+  PS2000A_TRIGGER_STATE channelB;
+  PS2000A_TRIGGER_STATE channelC;
+  PS2000A_TRIGGER_STATE channelD;
+  PS2000A_TRIGGER_STATE external;
+  PS2000A_TRIGGER_STATE aux;
+	PS2000A_TRIGGER_STATE digital;
+} PS2000A_PWQ_CONDITIONS;
+#pragma pack(pop)
+
+/// <summary>
+/// A structure of this type is passed to ps2000aSetTriggerChannelDirections in
+/// the directions argument to specify the trigger direction for a specified source.
+/// Not all driver series support this method.
+/// </summary>
+#pragma pack(push,1)
+typedef struct tPS2000ADigitalChannelDirections
+{
+	/// <summary>
+	/// The channel being configured. Channels supported by series SetChannel for allowable values.
+	/// </summary>
+	PS2000A_DIGITAL_CHANNEL channel;
+	/// <summary>
+	/// The trigger direction that should be applied to each channel.
+	/// </summary>
+	PS2000A_DIGITAL_DIRECTION direction;
+} PS2000A_DIGITAL_CHANNEL_DIRECTIONS;
+#pragma pack(pop)
+
+/// <summary>
+/// A structure of this type is passed to ps2000aSetTriggerChannelProperties in the
+/// channelProperties argument to specify the trigger mechanism.
+/// All values are scaled in 16-bit ADC counts at the currently selected range for that channel.
+/// </summary>
+#pragma pack(push,1)
+typedef struct tPS2000ATriggerChannelProperties
+{
+	/// <summary>
+	/// The upper threshold at which the trigger must fire
+	/// </summary>
+  int16_t										thresholdUpper;
+	/// <summary>
+	/// The hysteresis by which the trigger must exceed the upper threshold before it will fire.
+	/// </summary>
+	uint16_t					thresholdUpperHysteresis;
+	/// <summary>
+	/// The lower threshold at which the trigger must fire.
+	/// </summary>
+  int16_t										thresholdLower;
+	/// <summary>
+	/// The hysteresis by which the trigger must exceed the lower threshold before it will fire.
+	/// </summary>
+	uint16_t					thresholdLowerHysteresis;
+	/// <summary>
+	/// The channel to which the properties apply
+	/// </summary>
+	PS2000A_CHANNEL					channel;
+	/// <summary>
+	/// Either a level or window trigger
+	/// </summary>
+  PS2000A_THRESHOLD_MODE	thresholdMode;
+} PS2000A_TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack(pop)
+
+/// <summary>
+/// Various methods of data reduction.
+/// Note that a single call to setting the buffers (ie. ps2000aSetDataBuffer) can only
+/// associate one buffer with one downsampling mode. If you intend to retrieve more than one
+/// downsampling mode from the get values functions, you must call set data buffer several
+///	times to associate a separate buffer with each channel and downsampling mode.
+/// </summary>
+typedef enum enPS2000ARatioMode
+{
+	/// <summary>
+	/// No downsampling. Returns the raw data values.
+	/// </summary>
+	PS2000A_RATIO_MODE_NONE,
+	/// <summary>
+	/// Reduces every block of n values to just two values: a minimum and a maximum.
+	/// The minimum and maximum values are returned in two separate buffers.
+	/// </summary>
+	PS2000A_RATIO_MODE_AGGREGATE = 1,
+	/// <summary>
+	/// Reduces every block of n values to a single value representing the
+	/// average (arithmetic mean) of all the values.
+	/// </summary>
+	PS2000A_RATIO_MODE_DECIMATE = 2,
+	/// <summary>
+	/// Reduces every block of n values to just the first value in the block,
+	/// discarding all the other values.
+	/// </summary>
+	PS2000A_RATIO_MODE_AVERAGE = 4,
+} PS2000A_RATIO_MODE;
+
+
+/// <summary>
+/// The pulse-width type.
+/// </summary>
+typedef enum enPS2000APulseWidthType
+{
+	/// <summary>
+	/// Do not use the pulse width qualifier
+	/// </summary>
+	PS2000A_PW_TYPE_NONE,
+	/// <summary>
+	/// Pulse width less than lower pulse width counter
+	/// </summary>
+  PS2000A_PW_TYPE_LESS_THAN,
+	/// <summary>
+	/// Pulse width greater than lower pulse width counter
+	/// </summary>
+	PS2000A_PW_TYPE_GREATER_THAN,
+	/// <summary>
+	/// Pulse width between lower and upper pulsee width counter
+	/// </summary>
+	PS2000A_PW_TYPE_IN_RANGE,
+	/// <summary>
+	/// Pulse width not between lower and upper pulse width counter
+	/// </summary>
+	PS2000A_PW_TYPE_OUT_OF_RANGE
+} PS2000A_PULSE_WIDTH_TYPE;
+
+typedef enum enPS2000AHoldOffType
+{
+	PS2000A_TIME,
+	PS2000A_MAX_HOLDOFF_TYPE
+} PS2000A_HOLDOFF_TYPE;
+
+#pragma pack(push,1)
+typedef struct tPS2000AScalingFactors
+{
+	PS2000A_CHANNEL channelOrPort;
+	PS2000A_RANGE   range;
+	int16_t         offset;
+	double          scalingFactor;
+}PS2000A_SCALING_FACTORS_VALUES;
+#pragma pack(pop)
+
+  /// <summary>
+  /// This callback function is part of your application. You register it with the ps3000a
+  /// driver using series RunBlock, and the driver calls it back when block-mode data is
+  /// ready. You can then download the data using series GetValues.
+  /// </summary>
+  /// <param name="handle">Device identifier returned by OpenUnit.</param>
+  /// <param name="status">Indicates whether an error occurred during collection of the data.</param>
+  /// <param name="pParameter">A void pointer passed from series RunBlock. Your callback function can write to this
+  ///  location to send any data, such as a status flag, back to your application.</param>
+typedef void (__stdcall *ps2000aBlockReady)
+	(
+		int16_t											handle,
+		PICO_STATUS								status,
+		void										*	pParameter
+	);
+
+/// <summary>
+/// This callback function is part of your application. You register it with the driver using
+/// series GetStreamingLatestValues, and the driver calls it back when streaming- mode data is
+/// ready. You can then download the data using the series GetValuesAsync function.
+/// </summary>
+/// <param name="handle">Device identifier returned by OpenUnit.</param>
+/// <param name="noOfSamples">The number of samples available.</param>
+/// <param name="startIndex">An index to the first valid sample in the buffer. This is
+///  the buffer that was previously passed to series SetDataBuffer.</param>
+/// <param name="overflow">Returns a set of flags that indicate whether an overvoltage has occurred
+///  on any of the channels.It is a bit pattern with bit 0 denoting Channel.</param>
+/// <param name="triggerAt">An index to the buffer indicating the location of the trigger point relative
+///  to startIndex.This parameter is valid only when triggered is non-zero.</param>
+/// <param name="triggered">A flag indicating whether a trigger occurred. If non-zero,
+///  a trigger occurred at the location indicated by triggerAt.</param>
+/// <param name="autoStop">The flag that was set in the call to series RunStreaming.</param>
+/// <param name="pParameter">a void pointer passed from series GetStreamingLatestValues.
+/// The callback function can write to this locatio.</param>
+typedef void (__stdcall *ps2000aStreamingReady)
+	(
+		int16_t    									handle,
+		int32_t     									noOfSamples,
+		uint32_t							startIndex,
+		int16_t    									overflow,
+		uint32_t							triggerAt,
+		int16_t    									triggered,
+		int16_t    									autoStop,
+		void										*	pParameter
+	);
+
+/// <summary>
+/// This is a callback function that you write to collect data from the driver. You supply a
+/// pointer to the function when you call ps3000aGetValuesAsync, and the driver calls
+/// your function back when the data is ready.
+/// </summary>
+/// <param name="handle">Device identifier returned by OpenUnit.</param>
+/// <param name="status">Indicates whether an error occurred during collection of the data.</param>
+/// <param name="noOfSamples">the number of samples collected.</param>
+/// <param name="overflow">A set of flags that indicates whether an overvoltage has
+/// occurred and on which channels.It is a bit field with bit 0 representing Channel A.</param>
+/// <param name="pParameter">A void pointer passed from ps3000aGetValuesAsync. The callback function can
+/// write to this location to send any data, such as a status flag, back to the application.
+/// The data type is defined by the application programmer.</param>
+typedef void (__stdcall *ps2000aDataReady)
+	(
+		int16_t    									handle,
+		PICO_STATUS								status,
+		uint32_t     				noOfSamples,
+		int16_t    									overflow,
+		void										*	pParameter
+	);
+
+/// <summary>
+/// This function opens a PicoScope 2000 Series (A API) scope attached to the computer.
+/// The maximum number of units that can be opened depends on the operating system, the kernel driver and the computer.
+/// </summary>
+/// <param name="handle"> on exit, the result of the attempt to open a scope:
+///                       -1 : if the scope fails to open
+///                       0 : if no scope is found
+///                       > 0 : a number that uniquely identifies the scope
+///                       If a valid handle is returned, it must be used in all subsequent calls
+///												to API functions to identify this scope.</param>
+/// <param name="serial">on entry, a null-terminated string containing the serial
+///                      number of the scope to be opened.If serial is NULL then the
+///                      function opens the first scope found; otherwise, it tries to open the
+///                      scope that matches the string.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_OS_NOT_SUPPORTED
+/// PICO_OPEN_OPERATION_IN_PROGRESS
+/// PICO_EEPROM_CORRUPT
+/// PICO_KERNEL_DRIVER_TOO_OLD
+/// PICO_FPGA_FAIL
+/// PICO_MEMORY_CLOCK_FREQUENCY
+/// PICO_FW_FAIL
+/// PICO_MAX_UNITS_OPENED
+/// PICO_NOT_FOUND(if the specified unit was not found)
+/// PICO_NOT_RESPONDING
+/// PICO_MEMORY_FAIL
+/// PICO_ANALOG_BOARD
+/// PICO_CONFIG_FAIL_AWG
+/// PICO_INITIALISE_FPGA
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aOpenUnit)
+  (
+	  int16_t											* handle,
+		int8_t											* serial
+	);
+
+/// <summary>
+/// This function opens a scope without blocking the calling thread. You can find out when
+/// it has finished by periodically calling ps2000aOpenUnitProgress until that function
+/// returns a non - zero value.
+/// </summary>
+/// <param name="status">a status code:
+///                      0 if the open operation was disallowed because another open
+///                      operation is in progress. 1 if the open operation was successfully.</param>
+/// <param name="serial">see ps2000aOpenUnit.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_OPEN_OPERATION_IN_PROGRESS
+/// PICO_OPERATION_FAILED
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aOpenUnitAsync)
+  (
+	  int16_t											* status,
+		int8_t											* serial
+	);
+
+/// <summary>
+/// This function checks on the progress of a request made to ps2000aOpenUnitAsync to
+/// open a scope.
+/// </summary>
+/// <param name="handle">This handle is valid only if the function returns PICO_OK.</param>
+/// <param name="progressPercent">On exit, the percentage progress towards
+///  opening the scope. 100% implies that the open operation is complete.</param>
+/// <param name="complete">Set to 1 when the open operation has finished.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_NULL_PARAMETER
+/// PICO_OPERATION_FAILED
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aOpenUnitProgress)
+	(
+	  int16_t 										* handle,
+	  int16_t 										* progressPercent,
+	  int16_t 										* complete
+	);
+
+/// <summary>
+/// This function retrieves information about the specified oscilloscope. If the device fails
+/// to open, or no device is opened only the driver version is available.
+/// </summary>
+/// <param name="handle">device identifier returned by ps2000aOpenUnit. If an invalid
+///  handle is passed, only the driver versions can be read.</param>
+/// <param name="string">On exit, the unit information string selected specified by
+/// the info argument.If string is NULL, only requiredSize is returned.</param>
+/// <param name="stringLength">The maximum number of chars that may be written to string.</param>
+/// <param name="requiredSize">On exit, the required length of the string array.</param>
+/// <param name="info">a number specifying what information is required.
+/// The possible values are listed in the table below.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_INVALID_HANDLE
+/// PICO_NULL_PARAMETER
+/// PICO_INVALID_INFO
+/// PICO_INFO_UNAVAILABLE
+/// PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetUnitInfo)
+ 	(
+	  int16_t     								  handle,
+	  int8_t      								* string,
+	  int16_t     								  stringLength,
+	  int16_t     								* requiredSize,
+	  PICO_INFO 								  info
+	);
+
+/// <summary>
+/// This function flashes the LED on the front of the scope without blocking the calling
+/// thread.Calls to ps2000aRunStreaming and ps2000aRunBlock cancel any flashing
+/// started by this function.It is not possible to set the LED to be constantly illuminated,
+///  as this state is used to indicate that the scope has not been initialized.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="start">the action required:
+///            < 0 : flash the LED indefinitely
+///            0 : stop the LED flashing
+///            > 0 : flash the LED start times.If the LED is already flashing
+///                  on entry to this function, the flash count will be reset to start.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_HANDLE_INVALID
+///	PICO_BUSY
+///	PICO_DRIVER_FUNCTION
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aFlashLed)
+	(
+	  int16_t 											handle,
+		int16_t 											start
+	);
+
+/// <summary>
+/// This function shuts down an oscilloscope.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_HANDLE_INVALID
+///	PICO_USER_CALLBACK
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aCloseUnit)
+	(
+	  int16_t												handle
+	);
+
+/// <summary>
+/// This function sets the number of memory segments that the scope will use. When the scope is opened,
+/// the number of segments defaults to 1, meaning that each capture fills the scope's available memory.
+/// This function allows you to divide the memory into a number of segments so that the scope can
+/// store several waveforms sequentially.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="nSegments">The number of segments required, from 1 to ps2000aGetMaxSegments.</param>
+/// <param name="nMaxSamples">on exit, the number of samples available in each segment.This is
+///  the total number over all channels, so if more than one channel is in use then the number
+///  of samples available to each channel is nMaxSamples divided by the number of channels.</param>
+/// <returns>
+///	PICO_OK
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_HANDLE
+///	PICO_TOO_MANY_SEGMENTS
+///	PICO_MEMORY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aMemorySegments)
+	(
+	  int16_t												handle,
+		uint32_t							nSegments,
+		int32_t											* nMaxSamples
+	);
+
+/// <summary>
+/// This function specifies whether an input channel is to be enabled, its input coupling
+///	type, voltage range, analog offset.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="channel">, the channel to be configured. The values are:
+///		PS2000A_CHANNEL_A: Channel A input
+///		PS2000A_CHANNEL_B : Channel B input
+///		PS2000A_CHANNEL_C : Channel C input
+///		PS2000A_CHANNEL_D : Channel D input</param>
+/// <param name="enabled">Whether or not to enable the channel. The values are:
+///		TRUE: enable
+///		FALSE : do not enable</param>
+/// <param name="type">the impedance and coupling type. The values are:
+///		PS2000A_AC: 1 megohm impedance, AC coupling.The channel accepts input frequencies
+///               from about 1 hertz up to its maximum analog bandwidth.
+///		PS2000A_DC: 1 megohm impedance, DC coupling.The channel accepts all input frequencies
+///               from zero(DC) up to its maximum analog bandwidth.</param>
+/// <param name="range">The input voltage range.</param>
+/// <param name="analogOffset">a voltage to add to the input channel before digitization.
+/// The allowable range of offsets can be obtained from ps2000aGetAnalogueOffset and depends
+/// on the input range selected for the channel.This argument is ignored if the device is a
+/// PicoScope 2205 MSO.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_VOLTAGE_RANGE
+///	PICO_INVALID_COUPLING
+///	PICO_INVALID_ANALOGUE_OFFSET
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetChannel)
+ 	(
+	  int16_t												handle,
+		PS2000A_CHANNEL							channel,
+	  int16_t												enabled,
+	  PS2000A_COUPLING						type,
+		PS2000A_RANGE								range,
+		float												analogOffset
+	);
+
+/// <summary>
+/// This function is used to enable the digital ports of an MSO and set the logic level (the
+///	voltage point at which the state transitions from 0 to 1).
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="port">the digital port to be configured:
+///		PS2000A_DIGITAL_PORT0 = 0x80 (D0 to D7)
+///		PS2000A_DIGITAL_PORT1 = 0x81 (D8 to D15)</param>
+/// <param name="enabled">Whether or not to enable the channel. The values are:
+///		TRUE: enable
+///		FALSE : do not enable</param>
+/// <param name="logicLevel">The logic threshold voltage. Range: �32767 (�5 V) to 32767 (5 V).</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_CHANNEL
+///	PICO_RATIO_MODE_NOT_SUPPORTED
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetDigitalPort)
+ 	(
+	  int16_t												handle,
+		PS2000A_DIGITAL_PORT				port,
+	  int16_t												enabled,
+		int16_t									      logicLevel
+	);
+
+
+/// <summary>
+/// This function sets the number of captures to be collected in one run of rapid block
+///	mode.If you do not call this function before a run, the driver will capture only one
+///	waveform.Once a value has been set, the value remains constant unless changed.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="nCaptures">The number of waveforms to capture in one run.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetNoOfCaptures)
+	(
+	int16_t handle,
+	uint32_t nCaptures
+	);
+
+/// <summary>
+/// This function calculates the sampling rate and maximum number of samples for a
+/// given timebase under the specified conditions.The result will depend on the number of
+/// channels enabled by the last call to ps2000aSetChannel.
+///
+/// This function is provided for use with programming languages that do not support the
+/// float data type.The value returned in the timeIntervalNanoseconds argument is
+/// restricted to integers.If your programming language supports the float type, we
+/// recommend that you use ps2000aGetTimebase2 instead.
+///
+/// To use ps2000aGetTimebase or ps2000aGetTimebase2, first estimate the timebase
+/// number that you require using the information in the timebase guide.Next, call one of
+/// these functions with the timebase that you have just chosen and verify that the
+/// timeIntervalNanoseconds argument that the function returns is the value that you
+/// require.You may need to iterate this process until you obtain the time interval that you need.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="timebase">The timebase guide.</param>
+/// <param name="noSamples">The number of samples required.</param>
+/// <param name="timeIntervalNanoseconds">On exit, the time interval between readings at the
+///  selected timebase.Use NULL if not required.In ETS mode this argument is not valid;
+///  use the sample time returned by ps2000aSetEts.</param>
+/// <param name="oversample">Not used.</param>
+/// <param name="maxSamples">On exit, the maximum number of samples available. The scope allocates
+/// a certain amount of memory for internal overheads and this may vary depending on the number of
+///  segments, number of channels enabled, and the timebase chosen.Use NULL if not required.</param>
+/// <param name="segmentIndex">The index of the memory segment to use.</param>
+/// <returns>
+/// /// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_TOO_MANY_SAMPLES
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_TIMEBASE
+///	PICO_INVALID_PARAMETER
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetTimebase)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   int32_t											* timeIntervalNanoseconds,
+	   int16_t											oversample,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+/// <summary>
+/// This function is an upgraded version of ps2000aGetTimebase, and returns the time
+///	interval as a float rather than a long.This allows it to return sub - nanosecond time
+///	intervals.See ps2000aGetTimebase for a full description.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="timebase">The timebase guide.</param>
+/// <param name="noSamples">The number of samples required.</param>
+/// <param name="timeIntervalNanoseconds">A pointer to the time interval between readings at
+///  the selected timebase.If a null pointer is passed, the parameter will be ignored.</param>
+/// <param name="oversample">Not used.</param>
+/// <param name="maxSamples">On exit, the maximum number of samples available. The scope allocates
+/// a certain amount of memory for internal overheads and this may vary depending on the number of
+///  segments, number of channels enabled, and the timebase chosen.Use NULL if not required.</param>
+/// <param name="segmentIndex">The index of the memory segment to use.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_TOO_MANY_SAMPLES
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_TIMEBASE
+///	PICO_INVALID_PARAMETER
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetTimebase2)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   float										* timeIntervalNanoseconds,
+	   int16_t											oversample,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+/// <summary>
+/// This function programs the signal generator to produce an arbitrary waveform. The arbitrary waveform
+/// generator uses direct digital synthesis (DDS). It maintains a 32 - bit phase accumulator that
+/// indicates the present location in the waveform.The top bits of the phase accumulator are used as
+/// an index into a buffer containing the arbitrary waveform.The remaining bits act as the fractional
+/// part of the index, enabling high - resolution control of output frequency and allowing the
+/// generation of lower frequencies.
+///
+/// The phase accumulator initially increments by startDeltaPhase.If the AWG is set to sweep mode, the
+/// phase increment is increased at specified intervals until it reaches stopDeltaPhase. The easiest way
+/// to obtain the values of startDeltaPhase and stopDeltaPhase necessary to generate the desired frequency
+/// is to call ps2000aSigGenFrequencyToPhase.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="offsetVoltage">The voltage offset, in microvolts, to be applied to the waveform.</param>
+/// <param name="pkToPk">The peak-to-peak voltage, in microvolts, of the waveform signal.</param>
+/// <param name="startDeltaPhase">The initial value added to the phase accumulator as the generator
+///	begins to step through the waveform buffer.Calculate this value from the information above, or use
+/// ps2000aSigGenFrequencyToPhase.</param>
+/// <param name="stopDeltaPhase">The final value added to the phase accumulator before the generator
+/// restarts or reverses the sweep.When frequency sweeping is not required, set equal to startDeltaPhase.</param>
+/// <param name="deltaPhaseIncrement">the amount added to the delta phase value every time the dwellCount
+/// period expires.This determines the amount by which the generator sweeps the output frequency in each
+/// dwell period.When frequency sweeping is not required, set to zero.</param>
+/// <param name="dwellCount">the time, in multiples of ddsPeriod, between successive additions of
+///	deltaPhaseIncrement to the delta phase accumulator.This determines the rate at which the generator
+/// sweeps the output frequency.Minimum value : PS2000A_MIN_DWELL_COUNT.</param>
+/// <param name="arbitaryWaveform">A buffer that holds the waveform pattern as a set of samples equally
+/// spaced in time.Each sample is scaled to an output voltage as follows:
+///
+///    vOUT = 1 �V *(pkToPk / 2) *(sample_value / 32767) + offsetVoltage
+///
+/// and clipped to the overall �2 V range of the AWG.</param>
+/// <param name="arbitaryWaveformSize">the size of the arbitrary waveform buffer, in samples, in the range:
+/// [minArbitraryWaveformSize, maxArbitraryWaveformSize] where minArbitraryWaveformSize and
+/// maxArbitraryWaveformSize are the values returned by ps2000aSigGenArbitraryMinMaxValues.</param>
+/// <param name="sweepType">, determines whether the startDeltaPhase is swept up to the stopDeltaPhase,
+/// or down to it, or repeatedly swept up and down.</param>
+/// <param name="operation">The type of waveform to be produced.</param>
+/// <param name="indexMode">Specifies how the signal will be formed from the arbitrary waveform data.
+/// Single and dual index modes are possible.</param>
+/// <param name="shots">0: sweep the frequency as specified by sweeps
+///	1...PS2000A_MAX_SWEEPS_SHOTS: the number of cycles of the waveform to be
+/// produced after a trigger event.sweeps must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN : start and run continuously after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="sweeps">0: produce number of cycles specified by shots
+/// 1..PS2000A_MAX_SWEEPS_SHOTS: the number of times to sweep the frequency after a trigger event,
+/// according to sweepType.shots must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN: start a sweep and continue after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="triggerType">The type of trigger that will be applied to the signal generator.</param>
+/// <param name="triggerSource">The source that will trigger the signal generator.
+/// If a trigger source other than P2000A_SIGGEN_NONE is specified, then either shots or sweeps,
+/// but not both, must be non - zero.</param>
+/// <param name="extInThreshold">Trigger level, in ADC counts, for external trigger.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_AWG_NOT_SUPPORTED
+///	PICO_BUSY
+///	PICO_INVALID_HANDLE
+///	PICO_SIG_GEN_PARAM
+///	PICO_SHOTS_SWEEPS_WARNING
+///	PICO_NOT_RESPONDING
+///	PICO_WARNING_EXT_THRESHOLD_CONFLICT
+///	PICO_NO_SIGNAL_GENERATOR
+///	PICO_SIGGEN_OFFSET_VOLTAGE
+///	PICO_SIGGEN_PK_TO_PK
+///	PICO_SIGGEN_OUTPUT_OVER_VOLTAGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_SIGGEN_WAVEFORM_SETUP_FAILED
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetSigGenArbitrary)
+	(
+	 	int16_t												handle,
+	 	int32_t												offsetVoltage,
+	 	uint32_t								pkToPk,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+	 	int16_t											*	arbitraryWaveform,
+	 	int32_t												arbitraryWaveformSize,
+		PS2000A_SWEEP_TYPE					sweepType,
+		PS2000A_EXTRA_OPERATIONS		operation,
+		PS2000A_INDEX_MODE					indexMode,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS2000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS2000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+/// <summary>
+/// This function sets up the signal generator to produce a signal from a list of built-in
+/// waveforms.If different start and stop frequencies are specified, the device will sweep
+/// either up, down, or up and down.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="offsetVoltage">The voltage offset, in microvolts, to be applied to the waveform</param>
+/// <param name="pkToPk">The peak-to-peak voltage, in microvolts, of the waveform signal.
+///
+///  Note: if the signal voltages described by the combination of offsetVoltage and pkToPk
+///  extend outside the voltage range of the signal generator, the output waveform will be clipped.</param>
+/// <param name="waveType">The type of waveform to be generated.</param>
+/// <param name="startFrequency">The frequency that the signal generator will initially produce. See
+/// #defines above.</param>
+/// <param name="stopFrequency">The frequency at which the sweep reverses direction or returns to
+///	the initial frequency.</param>
+/// <param name="increment">The amount of frequency increase or decrease in sweep mode.</param>
+/// <param name="dwellTime">The time for which the sweep stays at each frequency, in seconds.</param>
+/// <param name="sweepType">whether the frequency will sweep from startFrequency to stopFrequency,
+///  or in the opposite direction, or repeatedly reverse direction.</param>
+/// <param name="operation">the type of waveform to be produced, specified by one of the following
+///	enumerated types :
+///		PS2000A_ES_OFF, normal signal generator operation specified by waveType.PS2000A_WHITENOISE,
+///	  the signal generator produces white noise and ignores all settings except pkToPk and offsetVoltage.
+///		PS2000A_PRBS, produces a random bitstream with a bit rate specified by the start and stop
+///		frequency(not available on PicoScope 2205 MSO).</param>
+/// <param name="shots">0: sweep the frequency as specified by sweeps
+///	1...PS2000A_MAX_SWEEPS_SHOTS: the number of cycles of the waveform to be
+/// produced after a trigger event.sweeps must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN : start and run continuously after trigger
+/// occurs(not PicoScope 2205 MSO)./param>
+/// <param name="sweeps">0: produce number of cycles specified by shots
+/// 1..PS2000A_MAX_SWEEPS_SHOTS: the number of times to sweep the frequency after a trigger event,
+/// according to sweepType.shots must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN: start a sweep and continue after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="triggerType">The type of trigger that will be applied to the signal generator.</param>
+/// <param name="triggerSource">The source that will trigger the signal generator.
+/// If a trigger source other than P2000A_SIGGEN_NONE is specified, then either shots or sweeps,
+/// but not both, must be non - zero.</param>
+/// <param name="extInThreshold">Trigger level, in ADC counts, for external trigger.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_BUSY
+///	PICO_INVALID_HANDLE
+///	PICO_SIG_GEN_PARAM
+///	PICO_SHOTS_SWEEPS_WARNING
+///	PICO_NOT_RESPONDING
+///	PICO_WARNING_AUX_OUTPUT_CONFLICT
+///	PICO_WARNING_EXT_THRESHOLD_CONFLICT
+///	PICO_NO_SIGNAL_GENERATOR
+///	PICO_SIGGEN_OFFSET_VOLTAGE
+///	PICO_SIGGEN_PK_TO_PK
+///	PICO_SIGGEN_OUTPUT_OVER_VOLTAGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_SIGGEN_WAVEFORM_SETUP_FAILED
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSetSigGenBuiltIn)
+	(
+		int16_t												handle,
+		int32_t												offsetVoltage,
+		uint32_t								pkToPk,
+		int16_t												waveType,
+		float												startFrequency,
+		float												stopFrequency,
+		float												increment,
+		float												dwellTime,
+		PS2000A_SWEEP_TYPE					sweepType,
+		PS2000A_EXTRA_OPERATIONS		operation,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS2000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS2000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+		);
+
+/// <summary>
+/// This function sets up the signal generator. It differs from ps2000SetSigGenBuiltIn in
+/// having double - precision arguments instead of floats, giving greater resolution when
+/// setting the output frequency.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="offsetVoltage">The voltage offset, in microvolts, to be applied to the waveform.</param>
+/// <param name="pkToPk">The peak-to-peak voltage, in microvolts, of the waveform signal.
+///
+///  Note: if the signal voltages described by the combination of offsetVoltage and pkToPk
+///  extend outside the voltage range of the signal generator, the output waveform will be clipped.</param>
+/// <param name="waveType">The type of waveform to be generated.</param>
+/// <param name="startFrequency">The frequency that the signal generator will initially produce. See
+/// #defines above.</param>
+/// <param name="stopFrequency">The frequency at which the sweep reverses direction or returns to
+///	the initial frequency.</param>
+/// <param name="increment">The amount of frequency increase or decrease in sweep mode.</param>
+/// <param name="dwellTime">The time for which the sweep stays at each frequency, in seconds.</param>
+/// <param name="sweepType">whether the frequency will sweep from startFrequency to stopFrequency,
+///  or in the opposite direction, or repeatedly reverse direction.</param>
+/// <param name="operation">the type of waveform to be produced, specified by one of the following
+///	enumerated types :
+///		PS2000A_ES_OFF, normal signal generator operation specified by waveType.PS2000A_WHITENOISE,
+///	  the signal generator produces white noise and ignores all settings except pkToPk and offsetVoltage.
+///		PS2000A_PRBS, produces a random bitstream with a bit rate specified by the start and stop
+///		frequency(not available on PicoScope 2205 MSO).</param>
+/// <param name="shots">0: sweep the frequency as specified by sweeps
+///	1...PS2000A_MAX_SWEEPS_SHOTS: the number of cycles of the waveform to be
+/// produced after a trigger event.sweeps must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN : start and run continuously after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="sweeps">0: produce number of cycles specified by shots
+/// 1..PS2000A_MAX_SWEEPS_SHOTS: the number of times to sweep the frequency after a trigger event,
+/// according to sweepType.shots must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN: start a sweep and continue after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="triggerType">The type of trigger that will be applied to the signal generator.</param>
+/// <param name="triggerSource">The source that will trigger the signal generator.
+/// If a trigger source other than P2000A_SIGGEN_NONE is specified, then either shots or sweeps,
+/// but not both, must be non - zero.</param>
+/// <param name="extInThreshold">Trigger level, in ADC counts, for external trigger.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_BUSY
+///	PICO_INVALID_HANDLE
+///	PICO_SIG_GEN_PARAM
+///	PICO_SHOTS_SWEEPS_WARNING
+///	PICO_NOT_RESPONDING
+///	PICO_WARNING_AUX_OUTPUT_CONFLICT
+///	PICO_WARNING_EXT_THRESHOLD_CONFLICT
+///	PICO_NO_SIGNAL_GENERATOR
+///	PICO_SIGGEN_OFFSET_VOLTAGE
+///	PICO_SIGGEN_PK_TO_PK
+///	PICO_SIGGEN_OUTPUT_OVER_VOLTAGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_SIGGEN_WAVEFORM_SETUP_FAILED
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSetSigGenBuiltInV2)
+	(
+		int16_t												handle,
+		int32_t												offsetVoltage,
+		uint32_t								pkToPk,
+		int16_t												waveType,
+		double												startFrequency,
+		double												stopFrequency,
+		double												increment,
+		double												dwellTime,
+		PS2000A_SWEEP_TYPE					sweepType,
+		PS2000A_EXTRA_OPERATIONS		operation,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS2000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS2000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+		);
+
+/// <summary>
+/// This function reprograms the arbitrary waveform generator. All values can be reprogrammed while
+/// the signal generator is waiting for a trigger.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startDeltaPhase">The initial value added to the phase accumulator as the generator
+///	begins to step through the waveform buffer.Calculate this value from the information above, or use
+/// ps2000aSigGenFrequencyToPhase.</param>
+/// <param name="stopDeltaPhase">The final value added to the phase accumulator before the generator
+/// restarts or reverses the sweep.When frequency sweeping is not required, set equal to startDeltaPhase.</param>
+/// <param name="deltaPhaseIncrement">the amount added to the delta phase value every time the dwellCount
+/// period expires.This determines the amount by which the generator sweeps the output frequency in each
+/// dwell period.When frequency sweeping is not required, set to zero.</param>
+/// <param name="dwellCount">the time, in multiples of ddsPeriod, between successive additions of
+///	deltaPhaseIncrement to the delta phase accumulator.This determines the rate at which the generator
+/// sweeps the output frequency.Minimum value : PS2000A_MIN_DWELL_COUNT.</param>
+/// <param name="arbitaryWaveform">A buffer that holds the waveform pattern as a set of samples equally
+/// spaced in time.Each sample is scaled to an output voltage as follows:
+///
+///    vOUT = 1 �V *(pkToPk / 2) *(sample_value / 32767) + offsetVoltage
+///
+/// and clipped to the overall �2 V range of the AWG.</param>
+/// <param name="arbitaryWaveformSize">the size of the arbitrary waveform buffer, in samples, in the range:
+/// [minArbitraryWaveformSize, maxArbitraryWaveformSize] where minArbitraryWaveformSize and
+/// maxArbitraryWaveformSize are the values returned by ps2000aSigGenArbitraryMinMaxValues.</param>
+/// <param name="sweepType">, determines whether the startDeltaPhase is swept up to the stopDeltaPhase,
+/// or down to it, or repeatedly swept up and down.</param>
+/// <param name="operation">The type of waveform to be produced.</param>
+/// <param name="indexMode">Specifies how the signal will be formed from the arbitrary waveform data.
+/// Single and dual index modes are possible.</param>
+/// <param name="shots">0: sweep the frequency as specified by sweeps
+///	1...PS2000A_MAX_SWEEPS_SHOTS: the number of cycles of the waveform to be
+/// produced after a trigger event.sweeps must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN : start and run continuously after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="sweeps">0: produce number of cycles specified by shots
+/// 1..PS2000A_MAX_SWEEPS_SHOTS: the number of times to sweep the frequency after a trigger event,
+/// according to sweepType.shots must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN: start a sweep and continue after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="triggerType">The type of trigger that will be applied to the signal generator.</param>
+/// <param name="triggerSource">The source that will trigger the signal generator.
+/// If a trigger source other than P2000A_SIGGEN_NONE is specified, then either shots or sweeps,
+/// but not both, must be non - zero.</param>
+/// <param name="extInThreshold">Trigger level, in ADC counts, for external trigger.</param>
+/// <returns>
+/// PICO_OK if successful
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SIGNAL_GENERATOR
+///	PICO_DRIVER_FUNCTION
+///	PICO_AWG_NOT_SUPPORTED
+///	PICO_SIGGEN_OFFSET_VOLTAGE
+///	PICO_SIGGEN_PK_TO_PK
+///	PICO_SIGGEN_OUTPUT_OVER_VOLTAGE
+///	PICO_SIG_GEN_PARAM
+///	PICO_SHOTS_SWEEPS_WARNING
+///	PICO_WARNING_EXT_THRESHOLD_CONFLICT
+///	PICO_BUSY
+///	PICO_SIGGEN_WAVEFORM_SETUP_FAILED
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetSigGenPropertiesArbitrary)
+	(
+	 	int16_t												handle,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+		PS2000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS2000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS2000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+/// <summary>
+/// This function reprograms the signal generator. Values can be changed while the signal
+///	generator is waiting for a trigger.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startFrequency">The frequency that the signal generator will initially produce. See
+/// #defines above.</param>
+/// <param name="stopFrequency">The frequency at which the sweep reverses direction or returns to
+///	the initial frequency.</param>
+/// <param name="increment">The amount of frequency increase or decrease in sweep mode.</param>
+/// <param name="dwellTime">The time for which the sweep stays at each frequency, in seconds.</param>
+/// <param name="sweepType">whether the frequency will sweep from startFrequency to stopFrequency,
+///  or in the opposite direction, or repeatedly reverse direction.</param>
+/// <param name="operation">the type of waveform to be produced, specified by one of the following
+///	enumerated types :
+///		PS2000A_ES_OFF, normal signal generator operation specified by waveType.PS2000A_WHITENOISE,
+///	  the signal generator produces white noise and ignores all settings except pkToPk and offsetVoltage.
+///		PS2000A_PRBS, produces a random bitstream with a bit rate specified by the start and stop
+///		frequency(not available on PicoScope 2205 MSO).</param>
+/// <param name="shots">0: sweep the frequency as specified by sweeps
+///	1...PS2000A_MAX_SWEEPS_SHOTS: the number of cycles of the waveform to be
+/// produced after a trigger event.sweeps must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN : start and run continuously after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="sweeps">0: produce number of cycles specified by shots
+/// 1..PS2000A_MAX_SWEEPS_SHOTS: the number of times to sweep the frequency after a trigger event,
+/// according to sweepType.shots must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN: start a sweep and continue after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="triggerType">The type of trigger that will be applied to the signal generator.</param>
+/// <param name="triggerSource">The source that will trigger the signal generator.
+/// If a trigger source other than P2000A_SIGGEN_NONE is specified, then either shots or sweeps,
+/// but not both, must be non - zero.</param>
+/// <param name="extInThreshold">Trigger level, in ADC counts, for external trigger.</param>
+/// <returns>
+/// PICO_OK if successful
+/// PICO_INVALID_HANDLE
+/// PICO_NO_SIGNAL_GENERATOR
+/// PICO_DRIVER_FUNCTION
+/// PICO_WARNING_EXT_THRESHOLD_CONFLICT
+/// PICO_SIGGEN_OFFSET_VOLTAGE
+/// PICO_SIGGEN_PK_TO_PK
+/// PICO_SIGGEN_OUTPUT_OVER_VOLTAGE
+/// PICO_SIG_GEN_PARAM
+/// PICO_SHOTS_SWEEPS_WARNING
+/// PICO_WARNING_EXT_THRESHOLD_CONFLICT
+/// PICO_BUSY
+/// PICO_SIGGEN_WAVEFORM_SETUP_FAILED
+/// PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSetSigGenPropertiesBuiltIn)
+	(
+		int16_t												handle,
+		double												startFrequency,
+		double												stopFrequency,
+		double												increment,
+		double												dwellTime,
+		PS2000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS2000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS2000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+/// <summary>
+/// This function converts a frequency to a phase count for use with the arbitrary waveform
+///  generator setup functions ps2000aSetSigGenArbitrary and ps2000aSetSigGenPropertiesArbitrary.
+/// The value returned depends on the length of the buffer, the index mode passed and the device model.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="frequency">The required AWG output frequency.</param>
+/// <param name="indexMode">See AWG index modes.</param>
+/// <param name="bufferLength">The number of samples in the AWG buffer.</param>
+/// <param name="phase">On exit, the deltaPhase argument to be sent to the AWG setup function.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_NOT_SUPPORTED_BY_THIS_DEVICE, if the device does not have an AWG.
+///	PICO_SIGGEN_FREQUENCY_OUT_OF_RANGE, if the frequency is out of range.
+///	PICO_NULL_PARAMETER, if phase is a NULL pointer.
+///	PICO_SIG_GEN_PARAM, if indexMode or bufferLength is out of range.
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	PS2000A_INDEX_MODE						indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+/// <summary>
+/// This function returns the range of possible sample values and waveform buffer sizes
+/// that can be supplied to ps2000aSetSigGenArbitrary for setting up the arbitrary
+/// waveform generator(AWG).These values may vary between models.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="minArbitraryWaveformValue">On exit, the lowest sample value allowed in the
+/// arbitraryWaveform buffer supplied to ps2000aSetChannelInfoSigGenArbitrary.</param>
+/// <param name="maxArbitraryWaveformValue">On exit, the highest sample value allowed in the
+///  arbitraryWaveform buffer supplied to ps2000aSetSigGenArbitrary.</param>
+/// <param name="minArbitraryWaveformSize">On exit, the minimum value allowed for the
+/// arbitraryWaveformSize argument supplied to ps2000aSetSigGenArbitrary.</param>
+/// <param name="maxArbitraryWaveformSize">On exit, the maximum value allowed for the
+/// arbitraryWaveformSize argument supplied to ps2000aSetSigGenArbitrary.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_NOT_SUPPORTED_BY_THIS_DEVICE, if the device does not have an arbitrary waveform generator.
+/// PICO_NULL_PARAMETER, if all the parameter pointers are NULL.
+/// PICO_INVALID_HANDLE
+/// PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+/// <summary>
+/// This function causes a trigger event, or starts and stops gating. Use it as follows:
+/// 1. Call ps2000aSetSigGenBuiltIn or ps2000aSetSigGenArbitrary to set up the signal generator,
+/// setting the triggerSource argument to SIGGEN_SOFT_TRIG.
+/// 2. (a)If you set the signal generator triggerType to edge triggering (PS2000A_SIGGEN_RISING or
+/// PS2000A_SIGGEN_FALLING), call ps2000aSigGenSoftwareControl once to trigger a capture.
+/// (b)If you set the signal generator triggerType to gated triggering (PS2000A_SIGGEN_GATE_HIGH
+/// or PS2000A_SIGGEN_GATE_LOW), call ps2000aSigGenSoftwareControl with state set to 0 to start
+/// capture, and then again with state set to 1 to stop capture.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="state">specifies whether to start or stop capture. Effective only when the signal
+/// generator triggerType is set to SIGGEN_GATE_HIGH or SIGGEN_GATE_LOW.Ignored for other trigger types.
+///			0: to start capture
+///			<> 0 : to stop </param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SIGNAL_GENERATOR
+///	PICO_SIGGEN_TRIGGER_SOURCE
+///	PICO_DRIVER_FUNCTION
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSigGenSoftwareControl)
+	(
+		int16_t												handle,
+		int16_t												state
+	);
+
+/// <summary>
+/// This function is used to enable or disable ETS (equivalent-time sampling) and to set
+///	the ETS parameters.See ETS overview for an explanation of ETS mode.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="mode">The ETS mode.</param>
+/// <param name="etsCycles">the number of cycles to store: the computer can then select etsInterleave
+///  cycles to give the most uniform spread of samples.Range: between two and five times the value of
+///  etsInterleave, and not more than the appropriate MAX_ETS_CYCLES constant:
+///	 see #defines above.</param>
+/// <param name="etsInterleave">the number of waveforms to combine into a single ETS capture.
+///	see #defines above for Maximum value.</param>
+/// <param name="sampleTimePicoseconds">on exit, the effective sampling interval of the ETS data.
+/// For example, if the captured sample time is 4 ns and etsInterleave is 10, then the effective
+/// sample time in ETS mode is 400 ps.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetEts)
+  (
+		int16_t												handle,
+		PS2000A_ETS_MODE						mode,
+		int16_t												etsCycles,
+		int16_t												etsInterleave,
+		int32_t											* sampleTimePicoseconds
+	);
+
+/// <summary>
+/// This function simplifies arming the trigger. It supports only the LEVEL trigger types
+/// and does not allow more than one channel to have a trigger applied to it.Any previous
+/// pulse width qualifier is canceled.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="enable">Zero to disable the trigger, any non-zero value to set the trigger.</param>
+/// <param name="source">The channel on which to trigger.</param>
+/// <param name="threshold">The ADC count at which the trigger will fire.</param>
+/// <param name="direction">The direction in which the signal must move to cause a trigger.</param>
+/// <param name="delay">The time between the trigger occurring and the first sample being taken.
+/// For example, if delay = 100 then the scope would wait 100 sample periods before sampling.</param>
+/// <param name="autoTrigger_ms">the number of milliseconds the device will wait if no trigger occurs.
+/// If this is set to zero, the scope device will wait indefinitely for a trigger.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_PARAMETER
+///	PICO_MEMORY
+///	PICO_CONDITIONS
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetSimpleTrigger)
+	(
+		int16_t handle,
+		int16_t enable,
+		PS2000A_CHANNEL source,
+		int16_t threshold,
+		PS2000A_THRESHOLD_DIRECTION direction,
+		uint32_t delay,
+		int16_t autoTrigger_ms
+	);
+
+/// <summary>
+/// This function will set the individual Digital channels trigger directions. Each trigger
+/// direction consists of a channel name and a direction.If the channel is not included in
+/// the array of PS2000A_DIGITAL_CHANNEL_DIRECTIONS the driver assumes the digital
+/// channel's trigger direction is PS2000A_DIGITAL_DONT_CARE.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="directions">a pointer to an array of PS2000A_DIGITAL_CHANNEL_DIRECTIONS
+/// structures describing the requested properties.The array can contain a single element
+/// describing the properties of one channel, or a number of elements describing several
+/// digital channels.If directions is NULL, digital triggering is switched off.A digital
+/// channel that is not included in the array will be set to PS2000A_DIGITAL_DONT_CARE.</param>
+/// <param name="nDirections">The number of digital channel directions being passed to the driver.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_INVALID_HANDLE
+/// PICO_DRIVER_FUNCTION
+/// PICO_INVALID_DIGITAL_CHANNEL
+/// PICO_INVALID_DIGITAL_TRIGGER_DIRECTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetTriggerDigitalPortProperties)
+(
+	int16_t handle,
+	PS2000A_DIGITAL_CHANNEL_DIRECTIONS * directions,
+	int16_t															   nDirections
+);
+
+/// <summary>
+/// Mixed-signal (MSO) models in this series have two independent triggers, one for the
+/// analog input channels and another for the digital inputs.This function defines how the
+/// two triggers are combined.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="operand">How the analogue and digital triggers will interact with each other.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_NOT_USED
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetDigitalAnalogTriggerOperand)
+(
+	int16_t handle,
+	PS2000A_TRIGGER_OPERAND operand
+);
+
+/// <summary>
+/// This function will set the individual digital channels' pulse-width trigger directions.
+///  Each trigger direction consists of a channel name and a direction. If the channel is not
+/// included in the array of PS2000A_DIGITAL_CHANNEL_DIRECTIONS the driver assumes the digital
+/// channel's pulse-width trigger direction is PS2000A_DIGITAL_DONT_CARE.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="directions">A pointer to an array of PS2000A_DIGITAL_CHANNEL_DIRECTIONS structures
+/// describing the requested properties.The array can contain a single element describing the
+/// properties of one channel, or a number of elements describing several digital channels.
+/// If directions is NULL, digital pulse - width triggering is switched off. A digital channel that
+/// is not included in the array will be set to PS2000A_DIGITAL_DONT_CARE.</param>
+/// <param name="nDirections">the number of digital channel directions being passed to the driver.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_DIGITAL_CHANNEL
+///	PICO_INVALID_DIGITAL_TRIGGER_DIRECTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetPulseWidthDigitalPortProperties)
+	(
+	int16_t                               handle,
+	PS2000A_DIGITAL_CHANNEL_DIRECTIONS *directions,
+	int16_t                               nDirections
+	);
+
+
+/// <summary>
+/// This function is used to enable or disable triggering and set its parameters.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="channelProperties">A pointer to an array of PS2000A_TRIGGER_CHANNEL_PROPERTIES
+/// structures describing the requested properties.The array can contain a single element
+///	describing the properties of one channel, or a number of elements describing several channels.
+/// If NULL is passed, triggering is switched off.</param>
+/// <param name="nChannelProperties">The size of the channelProperties array. If zero, triggering
+/// is switched off.</param>
+/// <param name="auxOutputEnable">Not used.</param>
+/// <param name="autoTriggerMilliseconds">The time in milliseconds for which the scope device will
+///  wait before collecting data if no trigger event occurs.If this is set to zero, the scope
+///  device will wait indefinitely for a trigger.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_TRIGGER_ERROR
+///	PICO_MEMORY
+///	PICO_INVALID_TRIGGER_PROPERTY
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetTriggerChannelProperties)
+	(
+		int16_t																	handle,
+		PS2000A_TRIGGER_CHANNEL_PROPERTIES	*	channelProperties,
+		int16_t																	nChannelProperties,
+		int16_t																	auxOutputEnable,
+		int32_t																	autoTriggerMilliseconds
+	);
+
+
+/// <summary>
+/// This function sets up trigger conditions on the scope's inputs. The trigger is defined by
+/// one or more PS2000A_TRIGGER_CONDITIONS structures that are then ORed together. Each structure
+///  is itself the AND of the states of one or more of the inputs.This AND - OR logic allows
+/// you to create any possible Boolean function of the scope's inputs.
+///
+///  If complex triggering is not required, use ps2000aSetSimpleTrigger.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="conditions">An array of PS2000A_TRIGGER_CONDITIONS structures specifying the
+/// conditions that should be applied to each channel. In the simplest case, the array consists
+/// of a single element.When there is more than one element, the overall trigger condition is
+/// the logical OR of all the elements.</param>
+/// <param name="nConditions">The number of elements in the conditions array. If nConditions is zero
+/// then triggering is switched.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_CONDITIONS
+///	PICO_MEMORY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetTriggerChannelConditions)
+	(
+		int16_t													handle,
+		PS2000A_TRIGGER_CONDITIONS	*	conditions,
+		int16_t													nConditions
+	);
+
+/// <summary>
+/// This function sets the direction of the trigger for each channel.
+///
+/// If using a level trigger in conjunction with a pulse - width trigger, see the
+/// description of the direction argument to ps2000aSetPulseWidthQualifier for more information.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="channelA">The direction in which the signal must pass through the threshold
+/// to activate the trigger.</param>
+/// <param name="channelB">The direction in which the signal must pass through the threshold
+/// to activate the trigger.</param>
+/// <param name="channelC">The direction in which the signal must pass through the threshold
+/// to activate the trigger. Four channel variants only.</param>
+/// <param name="channelD">The direction in which the signal must pass through the threshold
+/// to activate the trigger. Four channel variants only.</param>
+/// <param name="ext">The direction in which the signal must pass through the threshold
+/// to activate the trigger.</param></param>
+/// <param name="aux">Not used.</param></param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetTriggerChannelDirections)
+	(
+		int16_t													handle,
+		PS2000A_THRESHOLD_DIRECTION		channelA,
+		PS2000A_THRESHOLD_DIRECTION		channelB,
+		PS2000A_THRESHOLD_DIRECTION		channelC,
+		PS2000A_THRESHOLD_DIRECTION		channelD,
+		PS2000A_THRESHOLD_DIRECTION		ext,
+		PS2000A_THRESHOLD_DIRECTION		aux
+	);
+
+/// <summary>
+/// This function sets the post-trigger delay, which causes capture to start a defined time
+/// after the trigger event.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="delay">The time between the trigger occurring and the first sample. For example,
+///  if delay=100 then the scope would wait 100 sample periods before sampling.At a timebase of
+///  1GS/s, or 1ns per sample, the total delay would then be 100 x 1 ns = 100 ns.Range:
+///			0 to MAX_DELAY_COUNT.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetTriggerDelay)
+	(
+		int16_t									handle,
+		uint32_t					delay
+	);
+
+/// <summary>
+/// This function sets up the conditions for pulse width qualification, which is used with
+///	either threshold triggering, level triggering or window triggering to produce
+/// time - qualified triggers.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="conditions">This function sets up the conditions for pulse width qualification,
+/// which is used with either threshold triggering, level triggering or window triggering to
+/// produce time - qualified triggers.</param>
+/// <param name="nConditions">The number of elements in the conditions array. If nConditions is
+/// zero then the pulse-width qualifier is not used. Range:
+///			0 to PS2000A_MAX_PULSE_WIDTH_QUALIFIER_COUNT.</param>
+/// <param name="directions">the direction of the signal required for the pulse width trigger to
+/// fire.See PS2000A_THRESHOLD_DIRECTION constants for the list of possible values.Each channel
+/// of the oscilloscope(except the EXT input) has two thresholds for each direction�for example,
+/// PS2000A_RISING and PS2000A_RISING_LOWER � so that one can be 	used for the pulse - width
+/// qualifier and the other for the level trigger.The driver will not let you use the same
+/// threshold for both triggers; so, for example, you cannot use PS2000A_RISING as the direction
+/// argument for both ps2000aSetTriggerConditions and ps2000aSetPulseWidthQualifier at the same
+/// time. There is no such restriction when using window triggers.</param>
+/// <param name="lower">The lower limit of the pulse-width counter, measured in sample periods.</param>
+/// <param name="upper">The upper limit of the pulse-width counter, measured in sample periods.
+/// This parameter is used only when the type is set to PS2000A_PW_TYPE_IN_RANGE or
+/// PS2000A_PW_TYPE_OUT_OF_RANGE.</param>
+/// <param name="type">The pulse-width type.</param>
+/// <returns>
+///	PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetPulseWidthQualifier)
+	(
+		int16_t													handle,
+		PS2000A_PWQ_CONDITIONS			*	conditions,
+		int16_t													nConditions,
+		PS2000A_THRESHOLD_DIRECTION		direction,
+		uint32_t									lower,
+		uint32_t									upper,
+		PS2000A_PULSE_WIDTH_TYPE			type
+	);
+
+/// <summary>
+/// This function discovers whether a trigger, or pulse width triggering, is enabled.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="triggerEnabled">on exit, indicates whether the trigger will successfully
+/// be set when ps2000aRunBlock or ps2000aRunStreaming is called.A non - zero value indicates
+/// that the trigger is set, zero that the trigger is not set.</param>
+/// <param name="pulseWidthQualifierEnabled">on exit, indicates whether the pulse width
+/// qualifier will successfully be set when ps2000aRunBlock or ps2000aRunStreaming is
+/// called.A non - zero value indicates that the pulse width qualifier is set, zero that
+/// the pulse width qualifier is not set.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NULL_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aIsTriggerOrPulseWidthQualifierEnabled)
+	(
+		int16_t 								handle,
+		int16_t 							* triggerEnabled,
+		int16_t 							* pulseWidthQualifierEnabled
+	);
+
+/// <summary>
+/// This function gets the time, as two 4-byte values, at which the trigger occurred. Call it
+/// after block - mode data has been captured or when data has been retrieved from a
+/// previous block - mode capture.A 64 - bit version of this function,
+/// ps2000aGetTriggerTimeOffset64, is also available.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="timeUpper">on exit, the upper 32 bits of the time at which the trigger point occurred.</param>
+/// <param name="timeLower">on exit, the lower 32 bits of the time at which the trigger point occurred.</param>
+/// <param name="timeUnits">returns the time units in which timeUpper and timeLower are measured.</param>
+/// <param name="segmentIndex">the number of the memory segment for which the information is required.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DEVICE_SAMPLING
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_NOT_USED_IN_THIS_CAPTURE_MODE
+///	PICO_NOT_RESPONDING
+///	PICO_NULL_PARAMETER
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetTriggerTimeOffset)
+	(
+		int16_t									handle,
+		uint32_t 			* timeUpper,
+		uint32_t 			* timeLower,
+		PS2000A_TIME_UNITS	*	timeUnits,
+		uint32_t				segmentIndex
+	);
+
+/// <summary>
+/// This function gets the time, as a single 64-bit value, at which the trigger occurred. Call
+/// it after block - mode data has been captured or when data has been retrieved from a
+/// previous block - mode capture.A 32 - bit version of this function, ps2000aGetTriggerTimeOffset,
+/// is also available.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="time">On exit, the time at which the trigger point occurred.</param>
+/// <param name="timeUnits">On exit, the time units in which time is measured.</param>
+/// <param name="segmentIndex">Yhe number of the memory segment for which the information is required.</param>
+/// <returns>
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetTriggerTimeOffset64)
+	(
+		int16_t									handle,
+		int64_t							* time,
+		PS2000A_TIME_UNITS	*	timeUnits,
+		uint32_t				segmentIndex
+	);
+
+/// <summary>
+/// This function retrieves the time offsets, as lower and upper 32-bit values, for
+/// waveforms obtained in rapid block mode.The time offset of a waveform is the delay
+/// from the trigger sampling instant to the time at which the driver estimates the
+///	waveform to have crossed the trigger threshold.You can add this offset to the time of
+/// each sample in the waveform to reduce trigger jitter.Without using the time offset,
+/// trigger jitter can be up to 1 sample period; adding the time offset reduces jitter to a
+/// small fraction of a sample period.This function is provided for use in programming
+/// environments that do not support 64 - bit integers.If your programming environment
+/// supports this data type, it is easier to use ps2000aGetValuesTriggerTimeOffsetBulk64.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="timeUpper">An array of integers. On exit, the most significant 32
+///	bits of the time offset for each requested segment index.times[0] will hold the
+/// fromSegmentIndex time offset and the last times index will hold the toSegmentIndex
+/// time offset.The array must be long enough to hold the number of requested times.</param>
+/// <param name="timeLower">An array of integers. On exit, the least significant 32 bits
+/// of the time offset for each requested segment index.times[0] will hold the
+/// fromSegmentIndex time offset and the last times index will hold the toSegmentIndex
+/// time offset.The array size must be long enough to hold the number of requested times.</param>
+/// <param name="timeUnits">An array of integers. The array must be long enough to hold
+/// the number of requested times.On exit, timeUnits[0] will contain the time unit for
+/// fromSegmentIndex and the last element will contain the time unit for toSegmentIndex.
+/// Refer to ps2000aGetTriggerTimeOffset for allowable values.</param>
+/// <param name="fromSegmentIndex">The first segment for which the time offset is required</param>
+/// <param name="toSegmentIndex">The last segment for which the time offset is required.
+/// If toSegmentIndex is less than fromSegmentIndex then the driver will wrap around
+/// from the last segment to the first.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NOT_USED_IN_THIS_CAPTURE_MODE
+///	PICO_NOT_RESPONDING
+///	PICO_NULL_PARAMETER
+///	PICO_DEVICE_SAMPLING
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesTriggerTimeOffsetBulk)
+	(
+	  int16_t									handle,
+		uint32_t				*	timesUpper,
+		uint32_t				* timesLower,
+		PS2000A_TIME_UNITS	*	timeUnits,
+		uint32_t				fromSegmentIndex,
+		uint32_t				toSegmentIndex
+	);
+
+/// <summary>
+/// This function retrieves the 64-bit time offsets for waveforms captured in rapid block mode.
+/// A 32 - bit version of this function, ps2000aGetValuesTriggerTimeOffsetBulk, is available
+/// for use with programming languages that do not support 64 - bit integers.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="times">an array of integers. On exit, this will hold the time offset
+///	for each requested segment index.times[0] will hold the time offset for fromSegmentIndex,
+/// and the last times index will hold the time offset for toSegmentIndex.The array must be
+/// long enough to hold the number of times requested.</param>
+/// <param name="timeUnits">an array of integers long enough to hold the number of requested
+/// times.timeUnits[0] will contain the time unit for fromSegmentIndex, and the last element
+/// will contain the toSegmentIndex. Refer to ps2000aGetTriggerTimeOffset64 for specific
+/// figures.</param>
+/// <param name="fromSegmentIndex">the first segment for which the time offset is required.
+/// The results for this segment will be placed in times[0] and timeUnits[0].</param>
+/// <param name="toSegmentIndex">the last segment for which the time offset is required.
+/// The results for this segment will be placed in the last elements of the times and
+/// timeUnits arrays.If toSegmentIndex is less than fromSegmentIndex then the driver
+/// will wrap around from the last segment to the first.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NOT_USED_IN_THIS_CAPTURE_MODE
+///	PICO_NOT_RESPONDING
+///	PICO_NULL_PARAMETER
+///	PICO_DEVICE_SAMPLING
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesTriggerTimeOffsetBulk64)
+	(
+	  int16_t									handle,
+		int64_t							*	times,
+		PS2000A_TIME_UNITS	*	timeUnits,
+		uint32_t				fromSegmentIndex,
+		uint32_t				toSegmentIndex
+	);
+
+/// <summary>
+/// This function sets the number of captures to be collected in one run of rapid block
+/// mode. If you do not call this function before a run, the driver will capture only one
+/// waveform. Once a value has been set, the value remains constant unless changed.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="">the number of waveforms to capture in one run.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetNoOfCaptures)
+	(
+	  int16_t								handle,
+		uint32_t			*	nCaptures
+	);
+
+/// <summary>
+/// This function finds out how many captures in rapid block mode have been processed
+///	after ps2000aRunBlock has been called when either the collection completed or the
+///	collection of waveforms was interrupted by calling ps2000aStop.The returned value
+///	(nCaptures) can then be used to iterate through the number of segments using
+///	ps2000aGetValues, or in a single call to ps2000aGetValuesBulk where it is used to
+///	calculate the toSegmentIndex parameter.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="nProcessedCaptures">Output: the number of available captures that has
+///	been collected from calling ps2000aRunBlock.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_NULL_PARAMETER
+///	PICO_INVALID_PARAMETER
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_TOO_MANY_SAMPLES
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetNoOfProcessedCaptures)
+	(
+	  int16_t								handle,
+		uint32_t			*	nProcessedCaptures
+	);
+
+/// <summary>
+/// This function tells the driver where to store the data, either unprocessed or
+///	downsampled, that will be returned after the next call to one of the GetValues
+///	functions.The function allows you to specify only a single buffer, so for aggregation
+///	mode, which requires two buffers, you need to call ps2000aSetDataBuffers instead.
+///
+/// You must allocate memory for the buffer before calling this function.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="channelOrPort">The analogue channel you want to use with the buffer.
+/// To set the buffer for a digital port (MSO models only), use one of these values :
+///			PS2000A_DIGITAL_PORT0 = 0x80
+///			PS2000A_DIGITAL_PORT1 = 0x81</param>
+/// <param name="buffer">The location of the buffer.</param>
+/// <param name="bufferLth">The size of the buffer array.</param>
+/// <param name="segmentIndex">The number of the memory segment to be used.</param>
+/// <param name="mode">The downsampling mode. See PS2000A_RATIO_MODE for the available modes.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_CHANNEL
+///	PICO_RATIO_MODE_NOT_SUPPORTED
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetDataBuffer)
+(
+   int16_t								 handle,
+	 int32_t						 			 channelOrPort,
+	 int16_t							*  buffer,
+   int32_t									 bufferLth,
+	 uint32_t				 segmentIndex,
+	 PS2000A_RATIO_MODE		 mode
+);
+
+/// <summary>
+/// This function tells the driver the location of one or two buffers for receiving data. You
+///	need to allocate memory for the buffers before calling this function.If you do not need
+///	two buffers, because you are not using aggregate mode, you can optionally use
+///	ps2000aSetDataBuffer instead.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="channelOrPort">The analogue channel you want to use with the buffer.
+/// To set the buffer for a digital port (MSO models only), use one of these values :
+///			PS2000A_DIGITAL_PORT0 = 0x80
+///			PS2000A_DIGITAL_PORT1 = 0x81</param>
+/// <param name="bufferMax">A buffer to receive the maximum data values in aggregation mode,
+/// or the non - aggregated values otherwise.</param>
+/// <param name="bufferMin">A buffer to receive the minimum aggregated data values. Not used
+/// in other downsampling modes.</param>
+/// <param name="bufferLth">The size of the buffer array.</param>
+/// <param name="segmentIndex">The number of the memory segment to be used.</param>
+/// <param name="mode">The downsampling mode. See PS2000A_RATIO_MODE for the available modes.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_CHANNEL
+///	PICO_RATIO_MODE_NOT_SUPPORTED
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetDataBuffers)
+(
+   int16_t								 handle,
+	 int32_t						 			 channelOrPort,
+	 int16_t							 * bufferMax,
+	 int16_t							 * bufferMin,
+   int32_t									 bufferLth,
+	 uint32_t				 segmentIndex,
+	 PS2000A_RATIO_MODE		 mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSetUnscaledDataBuffers)
+(
+	int16_t               handle,
+	PS2000A_CHANNEL     channelOrPort,
+	int8_t              *bufferMax,
+	int8_t              *bufferMin,
+	int32_t                bufferLth,
+	uint32_t      segmentIndex,
+	PS2000A_RATIO_MODE  mode
+);
+/// <summary>
+/// This function tells the driver where to find your application's ETS time buffers. These
+///	buffers contain the 64 - bit timing information for each ETS sample after you run a
+///	block - mode ETS capture.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="buffer">An array of 64-bit words, each representing the time in
+/// femtoseconds(10^-15s) at which the sample was captured.</param>
+/// <param name="bufferLth">The size of the buffer array.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_INVALID_HANDLE
+/// PICO_NULL_PARAMETER
+/// PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetEtsTimeBuffer)
+(
+   int16_t									handle,
+	 int64_t *							buffer,
+	 int32_t										bufferLth
+);
+
+/// <summary>
+/// This function tells the driver where to find your application's ETS time buffers. These
+/// buffers contain the timing information for each ETS sample after you run a block - mode
+///	ETS capture.There are two buffers containing the upper and lower 32 - bit parts of the
+///	timing information, to allow programming languages that do not support 64 - bit data to
+///	retrieve the timings.
+
+/// If your programming language supports 64 - bit data then you can use ps2000aSetEtsTimeBuffer
+/// instead.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="timeUpper">An array of 32-bit words, each representing the upper
+/// 32 bits of the time in femtoseconds(10^�15s) at which the sample was captured.</param>
+/// <param name="timeLower">An array of 32-bit words, each representing the lower
+///	32 bits of the time in femtoseconds(10^�15s) at which the sample was captured.</param>
+/// <param name="bufferLth">The size of the timeUpper and timeLower arrays.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NULL_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetEtsTimeBuffers)
+(
+   int16_t									handle,
+	 uint32_t				* timeUpper,
+	 uint32_t				* timeLower,
+	 int32_t										bufferLth
+);
+
+/// <summary>
+/// This function may be used instead of a callback function to receive data from
+///	ps2000aRunBlock.To use this method, pass a NULL pointer as the lpReady argument
+///	to ps2000aRunBlock.You must then poll the driver to see if it has finished collecting
+///	the requested samples.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="ready">Output: indicates the state of the collection. If zero, the
+///	device is still collecting.If non - zero, the device has finished collecting and
+/// ps2000aGetValues can be used to retrieve the data.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_NULL_PARAMETER
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_CANCELLED
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aIsReady)
+	(
+		int16_t handle,
+		int16_t * ready
+	);
+
+/// <summary>
+/// This function starts collecting data in block mode. For a step-by-step guide to this
+///	process, see Using block mode.The number of samples is determined by noOfPreTriggerSamples
+///	and noOfPostTriggerSamples(see below for details).The total number of samples must
+///	not be more than the size of the segment referred to by segmentIndex.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="noOfPreTriggerSamples">The number of samples to store before the trigger event.</param>
+/// <param name="noOfPostTriggerSamples">The number of samples to store after the trigger event.
+///			Note: the maximum number of samples returned is always noOfPreTriggerSamples +
+///			noOfPostTriggerSamples. This is true even if no trigger event has been set.</param>
+/// <param name="timebase">A number in the range 0 to 2 32�1.See the guide to calculating timebase
+/// values.This argument is ignore.</param>
+/// <param name="oversample">Not used.</param>
+/// <param name="timeIndisposedMs">On exit, the time, in milliseconds, that the scope will spend
+/// collecting samples.This does not include any auto trigger timeout. It is not valid in ETS
+/// capture mode.The pointer can be set to null if a value is not required.</param>
+/// <param name="segmentIndex">Zero-based, which memory segment to use.</param>
+/// <param name="lpReady">A pointer to the ps2000aBlockReady callback function that the driver
+/// will call when the data has been collected.To use the ps2000aIsReady polling method instead
+/// of a callback function, set this pointer to NULL.</param>
+/// <param name="pParameter">a void pointer that is passed to the ps2000aBlockReady callback
+/// function.The callback can use this pointer to return arbitrary data to the application.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_BUFFERS_NOT_SET(in Overlapped mode)
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_TRIGGER_CHANNEL
+///	PICO_INVALID_CONDITION_CHANNEL
+///	PICO_TOO_MANY_SAMPLES
+///	PICO_INVALID_TIMEBASE
+///	PICO_NOT_RESPONDING
+///	PICO_CONFIG_FAIL
+///	PICO_INVALID_PARAMETER
+///	PICO_NOT_RESPONDING
+///	PICO_TRIGGER_ERROR
+///	PICO_DRIVER_FUNCTION
+///	PICO_FW_FAIL
+///	PICO_NOT_ENOUGH_SEGMENTS(in Bulk mode)
+///	PICO_PULSE_WIDTH_QUALIFIER
+///	PICO_SEGMENT_OUT_OF_RANGE(in Overlapped mode)
+///	PICO_STARTINDEX_INVALID(in Overlapped mode)
+///	PICO_INVALID_SAMPLERATIO(in Overlapped mode)
+///	PICO_CONFIG_FAIL
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aRunBlock)
+	(
+		int16_t									handle,
+		int32_t									noOfPreTriggerSamples,
+		int32_t									noOfPostTriggerSamples,
+		uint32_t					timebase,
+		int16_t									oversample,
+		int32_t								* timeIndisposedMs,
+		uint32_t				segmentIndex,
+		ps2000aBlockReady			lpReady,
+		void								* pParameter
+	);
+
+/// <summary>
+/// This function tells the oscilloscope to start collecting data in streaming mode. When
+///	data has been collected from the device it is downsampled if necessary and then
+///	delivered to the application.Call ps2000aGetStreamingLatestValues to retrieve the
+///	data. See Using streaming mode for a step - by - step guide to this process.When a
+/// trigger is set, the total number of samples stored in the driver is the sum of
+/// maxPreTriggerSamples and maxPostTriggerSamples.If autoStop is false, this will
+///	become the maximum number of samples without downsampling.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="sampleInterval">On entry, the requested time interval between samples; on exit, the actual
+/// time interval used.</param>
+/// <param name="sampleIntervalTimeUnits">The maximum number of raw samples before a trigger event for each enabled
+/// channel.If no trigger condition is set this argument is ignored.</param>
+/// <param name="maxPreTriggerSamples">The maximum number of raw samples after a trigger event for each enabled channel.
+/// If no trigger condition is set, this argument states the maximum number of samples to be stored.</param>
+/// <param name="maxPostPreTriggerSamples">A flag that specifies if the streaming should stop when all of maxSamples
+/// have been captured.</param>
+/// <param name="autoStop">A flag that specifies if the streaming should stop when all of maxSamples have
+/// been captured.</param>
+/// <param name="downSampleRatio">The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE for available modes.</param>
+/// <param name="overviewBufferSize">The size of the overview buffers. These are temporary buffers used for storing
+/// the data before returning it to the application.The size is the same as the bufferLth value passed
+/// to ps2000aSetDataBuffer.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_ETS_MODE_SET
+///	PICO_USER_CALLBACK
+///	PICO_NULL_PARAMETER
+///	PICO_INVALID_PARAMETER
+///	PICO_STREAMING_FAILED
+///	PICO_NOT_RESPONDING
+///	PICO_TRIGGER_ERROR
+///	PICO_INVALID_SAMPLE_INTERVAL
+///	PICO_INVALID_BUFFER
+///	PICO_DRIVER_FUNCTION
+///	PICO_FW_FAIL
+///	PICO_MEMORY
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aRunStreaming)
+  (
+	  int16_t									handle,
+		uint32_t				* sampleInterval,
+		PS2000A_TIME_UNITS		sampleIntervalTimeUnits,
+	  uint32_t					maxPreTriggerSamples,
+	  uint32_t					maxPostPreTriggerSamples,
+		int16_t									autoStop,
+		uint32_t					downSampleRatio,
+		PS2000A_RATIO_MODE		downSampleRatioMode,
+    uint32_t					overviewBufferSize
+	);
+
+/// <summary>
+/// This function instructs the driver to return the next block of values to your
+///	ps2000aStreamingReady callback function.You must have previously called
+///	ps2000aRunStreaming beforehand to set up streaming.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="lpPs2000aReady">a pointer to your ps2000aStreamingReady callback function.</param>
+/// <param name="pParameter">a void pointer that will be passed to the ps2000aStreamingReady
+/// callback function.The callback function may optionally use this pointer to return
+/// information to the application.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_INVALID_CALL
+///	PICO_BUSY
+///	PICO_NOT_RESPONDING
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetStreamingLatestValues)
+  (
+    int16_t									handle,
+    ps2000aStreamingReady	lpPs2000aReady,
+		void								* pParameter
+  );
+
+/// <summary>
+/// This function returns the number of samples available after data collection in
+///	streaming mode.Call it after calling ps2000aStop.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="noOfValues">On exit, the number of samples.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NULL_PARAMETER
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_NOT_USED
+///	PICO_BUSY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aNoOfStreamingValues)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfValues
+	);
+
+/// <summary>
+/// This function returns the maximum downsampling ratio that can be used for a given
+///	number of samples in a given downsampling mode
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="noOfUnaggreatedSamples">The number of unprocessed samples to be downsampled.</param>
+/// <param name="maxDownSampleRatio">The maximum possible downsampling ratio output.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE available modes.</param>
+/// <param name="segmentIndex">The memory segment where the data is stored.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_NULL_PARAMETER
+///	PICO_INVALID_PARAMETER
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_TOO_MANY_SAMPLES
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetMaxDownSampleRatio)
+	(
+	  int16_t								handle,
+		uint32_t 			noOfUnaggreatedSamples,
+		uint32_t 		* maxDownSampleRatio,
+		PS2000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t			segmentIndex
+	);
+
+/// <summary>
+/// This function returns block-mode data, with or without downsampling, starting at the
+///	specified sample number.It is used to get the stored data from the driver after data
+///	collection has stopped.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startIndex">A zero-based index that indicates the start point for
+///	data collection.It is measured in sample intervals from the start of the buffer.</param>
+/// <param name="noOfSamples">On entry, the number of samples required. On exit,
+/// the actual number retrieved. The number of samples retrieved will not be more than the
+/// number requested, and the data retrieved starts at startIndex.</param>
+/// <param name="downSampleRatio">The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">Downsampling mode to use. The available values are :
+///			PS2000A_RATIO_MODE_NONE(downSampleRatio is ignored)
+///			PS2000A_RATIO_MODE_AGGREGATE
+///			PS2000A_RATIO_MODE_AVERAGE
+///			PS2000A_RATIO_MODE_DECIMATE
+///	AGGREGATE, AVERAGE, DECIMATE are single - bit constants that can be ORed to apply multiple
+/// downsampling modes to the same data.</param>
+/// <param name="segmentIndex">The zero-based number of the memory segment 	where the data is stored.</param>
+/// <param name="overflow">On exit, a set of flags that indicate whether an overvoltage has occurred
+/// on any of the channels.It is a bit field with bit 0 denoting Channel.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_DEVICE_SAMPLING
+///	PICO_NULL_PARAMETER
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_STARTINDEX_INVALID
+///	PICO_ETS_NOT_RUNNING
+///	PICO_BUFFERS_NOT_SET
+///	PICO_INVALID_PARAMETER
+///	PICO_TOO_MANY_SAMPLES
+///	PICO_DATA_NOT_AVAILABLE
+///	PICO_STARTINDEX_INVALID
+///	PICO_INVALID_SAMPLERATIO
+///	PICO_INVALID_CALL
+///	PICO_NOT_RESPONDING
+///	PICO_MEMORY
+///	PICO_RATIO_MODE_NOT_SUPPORTED
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValues)
+	(
+	  int16_t								handle,
+		uint32_t 			startIndex,
+	  uint32_t			*	noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS2000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t			segmentIndex,
+		int16_t							* overflow
+	);
+
+/// <summary>
+/// This function retrieves waveforms captured using rapid block mode. The waveforms
+///	must have been collected sequentially and in the same run.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="noOfSamples">On entry, the number of samples required; on exit, the actual
+///  number retrieved. The number of samples retrieved will not be more than the number
+///  requested.The data retrieved always starts with the first sample captured.</param>
+/// <param name="fromSegmentIndex">The first segment from which the waveform should be retrieved.</param>
+/// <param name="toSegmentIndex">The last segment from which the waveform should be retrieved.</param>
+/// <param name="downSampleRatio">The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE for available modes.</param>
+/// <param name="overflow">An array of integers equal to or larger than the number of waveforms to
+/// be retrieved.Each segment index has a corresponding entry in the overflow array, with overflow[0]
+/// containing the flags for the segment numbered fromSegmentIndex and the last element in the
+/// array containing the flags for the segment numbered toSegmentIndex. Each element in the array
+/// is a bit field.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_INVALID_SAMPLERATIO
+///	PICO_ETS_NOT_RUNNING
+///	PICO_BUFFERS_NOT_SET
+///	PICO_TOO_MANY_SAMPLES
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_NOT_RESPONDING
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesBulk)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfSamples,
+		uint32_t			fromSegmentIndex,
+		uint32_t			toSegmentIndex,
+	  uint32_t				downSampleRatio,
+		PS2000A_RATIO_MODE 	downSampleRatioMode,
+		int16_t							* overflow
+	);
+
+/// <summary>
+/// This function returns data either with or without downsampling, starting at the
+/// specified sample number.It is used to get the stored data from the scope after data
+/// collection has stopped.It returns the data using a callback.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startIndex">A zero-based index that indicates the start point for data collection.
+/// It is measured in sample intervals from the start of the buffer.</param>
+/// <param name="noOfSamples">On entry, the number of samples required. On exit, the actual number
+/// retrieved. The number of samples retrieved will not be more than the number requested, and the
+/// data retrieved starts at startIndex.</param>
+/// <param name="downSampleRatio">See The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE fro available modes.</param>
+/// <param name="segmentIndex">The zero-based number of the memory segment where the data is stored.</param>
+/// <param name="lpDataReady">A pointer to the user-supplied function that will be
+///	called when the data is ready.This will be a ps2000aDataReady function for
+/// block - mode data or a ps2000aStreamingReady function for streaming - mode data.</param>
+/// <param name="pParameter">a void pointer that will be passed to the callback function.The
+/// data type is determined by the application.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_DEVICE_SAMPLING
+///	PICO_NULL_PARAMETER
+///	PICO_STARTINDEX_INVALID
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_INVALID_PARAMETER
+///	PICO_DATA_NOT_AVAILABLE
+///	PICO_INVALID_SAMPLERATIO
+///	PICO_INVALID_CALL
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesAsync)
+	(
+	  int16_t								handle,
+		uint32_t				startIndex,
+	  uint32_t				noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS2000A_RATIO_MODE		downSampleRatioMode,
+		uint32_t			segmentIndex,
+	  void							*	lpDataReady,
+		void							*	pParameter
+	);
+
+/// <summary>
+/// This function allows you to make a deferred data-collection request in block mode. The
+///	request will be executed, and the arguments validated, when you call
+///	ps2000aRunBlock.The advantage of this function is that the driver makes contact with
+///	the scope only once, when you call ps2000aRunBlock, compared with the two contacts
+///	that occur when you use the conventional ps2000aRunBlock, ps2000aGetValues
+///	calling sequence.This slightly reduces the dead time between successive captures in
+///	block mode.
+///
+/// After calling ps2000aRunBlock, you can optionally use ps2000aGetValues to request
+///	further copies of the data.This might be required if you wish to display the data with
+///	different data reduction settings.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startIndex">A zero-based index that indicates the start point for data
+/// collection.It is measured in sample intervals from the start of the buffer</param>
+/// <param name="noOfSamples">n entry, the number of raw samples to be collected before any
+/// downsampling is applied.On exit, the actual number stored in the buffer.The number of
+/// samples retrieved will not be more than the number requested, and the data retrieved
+/// starts at startIndex.</param>
+/// <param name="downSampleRatio">The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE for available modes.</param>
+/// <param name="segmentIndex">The zero-based number of the memory segment where the data is stored.</param>
+/// <param name="overflow">An array of integers equal to or larger than the number of waveforms to
+/// be retrieved.Each segment index has a corresponding entry in the overflow array, with overflow[0]
+///	containing the flags for the segment numbered fromSegmentIndex and the last element in the array
+/// containing the flags for the segment numbered toSegmentIndex.Each element in the array is a bit field</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesOverlapped)
+	(
+	  int16_t								handle,
+	  uint32_t 			startIndex,
+	  uint32_t			*	noOfSamples,
+	  uint32_t				downSampleRatio,
+	  PS2000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t      segmentIndex,
+	  int16_t				*       overflow
+	);
+
+
+/// <summary>
+/// This function allows you to make a deferred data-collection request, which will later be
+///	executed, and the arguments validated, when you call ps2000aRunBlock in rapid block
+///	mode.The advantage of this method is that the driver makes contact with the scope
+///	only once, when you call ps2000aRunBlock, compared with the two contacts that occur
+///	when you use the conventional ps2000aRunBlock, ps2000aGetValuesBulk calling
+///	sequence.This slightly reduces the dead time between successive captures in rapid
+///	block mode.
+///
+/// After calling ps2000aRunBlock, you can optionally use ps2000aGetValues to request
+///	further copies of the data.This might be required if you wish to display the data with
+///	different data reduction settings.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startIndex">A zero-based index that indicates the start point for data
+/// collection.It is measured in sample intervals from the start of the buffer</param>
+/// <param name="noOfSamples">On entry, the number of samples required; on exit, the actual
+///  number retrieved. The number of samples retrieved will not be more than the number
+///  requested.The data retrieved always starts with the first sample captured.</param>
+/// <param name="downSampleRatio">The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE for available modes.</param>
+/// <param name="fromSegmentIndex">The first segment from which the waveform should be retrieved.</param>
+/// <param name="toSegmentIndex">The last segment from which the waveform should be retrieved.</param>
+/// <param name="overflow">An array of integers equal to or larger than the number of waveforms to
+/// be retrieved.Each segment index has a corresponding entry in the overflow array, with overflow[0]
+/// containing the flags for the segment numbered fromSegmentIndex and the last element in the
+/// array containing the flags for the segment numbered toSegmentIndex. Each element in the array
+/// is a bit field.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesOverlappedBulk)
+	(
+	  int16_t								handle,
+		uint32_t				startIndex,
+  	uint32_t 	 	*	noOfSamples,
+	  uint32_t				downSampleRatio,
+	  PS2000A_RATIO_MODE	downSampleRatioMode,
+	  uint32_t			fromSegmentIndex,
+	  uint32_t			toSegmentIndex,
+	  int16_t							*	overflow
+	);
+
+/// <summary>
+/// This function stops the scope device from sampling data. If this function is called
+/// before a trigger event occurs, the oscilloscope may not contain valid data. Always
+/// call this function after the end of a capture to ensure that the scope is ready
+///	for the next capture.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aStop)
+	(
+	  int16_t handle
+	);
+
+/// <summary>
+/// This function has no effect and is reserved for future use.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="holdoff">Reserved for future use.</param>
+/// <param name="type">Reserved for future use.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NULL_PARAMETER
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_NOT_USED
+///	PICO_BUSY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aHoldOff)
+	(
+	  int16_t								handle,
+		uint64_t						holdoff,
+		PS2000A_HOLDOFF_TYPE	type
+	);
+
+/// <summary>
+/// This function queries which ranges are available on a scope device.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="info">The type of information required.
+///  The following value iscurrently supported : PS2000A_CI_RANGES</param>
+/// <param name="probe">Not used, must be set to 0.</param>
+/// <param name="ranges">An array that will be populated with available PS2000A_RANGE
+/// values for the given info.If NULL, length is set tothe number of ranges available.</param>
+/// <param name="length">Input: length of ranges array; output: number of elements
+///  written to ranges.</param>
+/// <param name="channels">The channel for which the information is required.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_HANDLE_INVALID
+///	PICO_BUSY
+///	PICO_DRIVER_FUNCTION
+///	PICO_NOT_RESPONDING
+///	PICO_NULL_PARAMETER
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_INFO
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetChannelInformation)
+	(
+		int16_t handle,
+		PS2000A_CHANNEL_INFO info,
+		int32_t probe,
+		int32_t * ranges,
+		int32_t * length,
+		int32_t channels
+  );
+
+/// <summary>
+/// This function counts the number of PicoScope 2000 Series (A API) units connected to
+///	the computer, and returns a list of serial numbers as a string.
+/// </summary>
+/// <param name="count">On exit, the number of ps2000a units found.</param>
+/// <param name="serials">On exit, a list of serial numbers separated by commas and terminated
+/// by a final null.
+///
+///				Example: AQ005 / 139, VDR61 / 356, ZOR14 / 107
+///
+/// Can be NULL on entry if serial numbers are not required.</param>
+/// <param name="serialLth">On entry, the length of the char buffer pointed to by serials;
+/// on exit, the length of the string written to serials.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_BUSY
+///	PICO_NULL_PARAMETER
+///	PICO_FW_FAIL
+///	PICO_CONFIG_FAIL
+///	PICO_MEMORY_FAIL
+///	PICO_CONFIG_FAIL_AWG
+///	PICO_INITIALISE_FPGA
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aEnumerateUnits)
+	(
+	int16_t * count,
+	int8_t * serials,
+	int16_t * serialLth
+	);
+
+/// <summary>
+/// This function can be used to check that the already opened device is still connected to
+///	the USB port and communication is successful.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_BUSY
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aPingUnit)
+	(
+	int16_t handle
+	);
+
+/// <summary>
+/// This function returns the maximum ADC count returned by calls to the "GetValues"
+///	functions.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="value">Output: the maximum ADC value.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_HANDLE
+///	PICO_TOO_MANY_SEGMENTS
+///	PICO_MEMORY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aMaximumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+/// <summary>
+/// This function returns the minimum ADC count returned by calls to the GetValues
+///	functions
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="value">Output: the minimum ADC value.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_HANDLE
+///	PICO_TOO_MANY_SEGMENTS
+///	PICO_MEMORY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aMinimumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+/// <summary>
+/// This function is used to get the maximum and minimum allowable analog offset for a
+///	specific voltage range.
+///
+///	If both maximumVoltage and minimumVoltage are NULL, the driver will return PICO_NULL_PARAMETER
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="range">The voltage range to be used when gathering the min and max information.</param>
+/// <param name="coupling">The type of AC/DC coupling used</param>
+/// <param name="maximumVoltage">Output: maximum voltage allowed for the range. Pointer will be
+/// ignored if NULL.If device does not support analog offset, zero will be returned.</param>
+/// <param name="minimumVoltage">Output: minimum voltage allowed for the range. Pointer will
+/// be ignored if NULL. If device does not support analog offset, zero will be returned.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_VOLTAGE_RANGE
+///	PICO_NULL_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetAnalogueOffset)
+	(
+	int16_t handle,
+	PS2000A_RANGE range,
+	PS2000A_COUPLING	coupling,
+	float * maximumVoltage,
+	float * minimumVoltage
+	);
+
+/// <summary>
+/// This function returns the maximum number of segments allowed for the opened
+///	variant.Refer to ps2000aMemorySegments for specific figures.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="maxSegments">Output: maximum number of segments allowed.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_NULL_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetMaxSegments)
+	(
+	int16_t		handle,
+	uint32_t * maxSegments
+	);
+
+/// <summary>
+/// Retrieves the current state of the output edge detect flag
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="state">Output: The current of the output edge detect</param>
+/// <returns>
+/// PICO_OK
+/// PICO_NOT_USED
+/// PICO_NULL_PARAMETER
+/// PICO_NOT_SUPPORTED_BY_THIS_DEVICE
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+	);
+
+/// <summary>
+/// Sets the state of the output edge detect flag, Default value is TRUE
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="state">The output edge detect state to be set:
+///			any none 0 value: enable
+///			0: disable</param>
+/// <returns>
+/// PICO_OK
+/// PICO_NOT_USED
+/// PICO_NULL_PARAMETER
+/// PICO_NOT_SUPPORTED_BY_THIS_DEVICE
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aGetScalingValues)
+(
+	int16_t	handle,
+	PS2000A_SCALING_FACTORS_VALUES *scalingValues,
+	int16_t nChannels
+);
+
+#endif

+ 597 - 0
pico-tcp-service/pico-tcp-client/inc/ps3000.h

@@ -0,0 +1,597 @@
+/****************************************************************************
+ *
+ * Filename:    ps3000.h
+ * Author:      MTB & MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 3000 Series PC Oscilloscopes.
+ *
+ * Copyright � 2002 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef PS3000_H
+#define PS3000_H
+
+#include <stdint.h>
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+#ifdef PREF4
+  #undef PREF4
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+/*  If you are dynamically linking ps3000.dll into your project #define DYNLINK here
+ */
+#ifdef WIN32
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+  #define PREF4 __stdcall
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+#define PS3000_FIRST_USB  1
+#if defined (_DEBUG)
+#define PS3000_LAST_USB   64
+#else
+#define PS3000_LAST_USB 127
+#endif
+
+/* Maximum number of PS3000 units that can be opened at once
+ */
+#define PS3000_MAX_UNITS (PS3000_LAST_USB - PS3000_FIRST_USB + 1)
+
+#define PS3206_MAX_TIMEBASE  21
+#define PS3205_MAX_TIMEBASE  20
+#define PS3204_MAX_TIMEBASE  19
+#define PS3224_MAX_TIMEBASE  19
+#define PS3223_MAX_TIMEBASE  19
+#define PS3424_MAX_TIMEBASE  19
+#define PS3423_MAX_TIMEBASE  19
+
+#define PS3225_MAX_TIMEBASE  18
+#define PS3226_MAX_TIMEBASE  19
+#define PS3425_MAX_TIMEBASE  19
+#define PS3426_MAX_TIMEBASE  19
+
+#define PS3000_MAX_OVERSAMPLE 256
+
+/* Although the PS3000 uses an 8-bit ADC, it is usually possible to
+ * oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+
+#define PS3000_MAX_VALUE  32767
+#define PS3000_MIN_VALUE -32767
+#define PS3000_LOST_DATA -32768
+
+/*
+ * Signal generator constants. Note that a signal generator is not
+ * available on all variants.
+ */
+#define PS3000_MIN_SIGGEN_FREQ  0.093
+#define PS3000_MAX_SIGGEN_FREQ  1000000L
+
+/*
+ * ETS constants
+ */
+#define PS3206_MAX_ETS_CYCLES      500
+#define PS3206_MAX_ETS_INTERLEAVE  100
+
+#define PS3205_MAX_ETS_CYCLES      250
+#define PS3205_MAX_ETS_INTERLEAVE   50
+
+#define PS3204_MAX_ETS_CYCLES      125
+#define PS3204_MAX_ETS_INTERLEAVE   25
+
+#define PS3000_MAX_ETS_CYCLES_INTERLEAVE_RATIO  10
+#define PS3000_MIN_ETS_CYCLES_INTERLEAVE_RATIO   1
+#define PS300_MAX_ETS_SAMPLES 100000
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+#define MAX_HOLDOFF_COUNT 8388607L
+
+typedef enum enPS3000Channel
+{
+  PS3000_CHANNEL_A,
+  PS3000_CHANNEL_B,
+  PS3000_CHANNEL_C,
+  PS3000_CHANNEL_D,
+  PS3000_EXTERNAL,
+  PS3000_MAX_CHANNELS = PS3000_EXTERNAL,
+  PS3000_NONE,
+  PS3000_MAX_TRIGGER_SOURCES
+}  PS3000_CHANNEL;
+
+typedef enum enPS3000Range
+{
+  PS3000_10MV,
+  PS3000_20MV,
+  PS3000_50MV,
+  PS3000_100MV,
+  PS3000_200MV,
+  PS3000_500MV,
+  PS3000_1V,
+  PS3000_2V,
+  PS3000_5V,
+  PS3000_10V,
+  PS3000_20V,
+  PS3000_50V,
+  PS3000_100V,
+  PS3000_200V,
+  PS3000_400V,
+  PS3000_MAX_RANGES
+}  PS3000_RANGE;
+
+typedef enum enPS3000WaveTypes
+  {
+  PS3000_SQUARE,
+  PS3000_TRIANGLE,
+  PS3000_SINE,
+  PS3000_MAX_WAVE_TYPES
+  }  PS3000_WAVE_TYPES;
+
+typedef enum enPS3000TimeUnits
+  {
+  PS3000_FS,
+  PS3000_PS,
+  PS3000_NS,
+  PS3000_US,
+  PS3000_MS,
+  PS3000_S,
+  PS3000_MAX_TIME_UNITS,
+  }  PS3000_TIME_UNITS;
+
+typedef enum enPS3000Error
+  {
+  PS3000_OK,
+  PS3000_MAX_UNITS_OPENED,  // more than PS3000_MAX_UNITS
+  PS3000_MEM_FAIL,      //not enough RAM on host machine
+  PS3000_NOT_FOUND,      //cannot find device
+  PS3000_FW_FAIL,      //unabled to download firmware
+  PS3000_NOT_RESPONDING,
+  PS3000_CONFIG_FAIL,    //missing or corrupted configuration settings
+  PS3000_OS_NOT_SUPPORTED,  //need to use win98SE (or later) or win2k (or later)
+  PS3000_PICOPP_TOO_OLD,
+  }  PS3000_ERROR;
+
+typedef enum enPS3000Info
+{
+  PS3000_DRIVER_VERSION,
+  PS3000_USB_VERSION,
+  PS3000_HARDWARE_VERSION,
+  PS3000_VARIANT_INFO,
+  PS3000_BATCH_AND_SERIAL,
+  PS3000_CAL_DATE,
+  PS3000_ERROR_CODE,
+  PS3000_KERNEL_DRIVER_VERSION,
+  PS3000_DRIVER_PATH
+}  PS3000_INFO;
+
+typedef enum enPS3000TriggerDirection
+  {
+  PS3000_RISING,
+  PS3000_FALLING,
+  PS3000_MAX_DIRS
+  }  PS3000_TDIR;
+
+typedef enum enPS3000OpenProgress
+  {
+  PS3000_OPEN_PROGRESS_FAIL     = -1,
+  PS3000_OPEN_PROGRESS_PENDING  = 0,
+  PS3000_OPEN_PROGRESS_COMPLETE = 1
+  } PS3000_OPEN_PROGRESS;
+
+typedef enum enPS3000EtsMode
+  {
+  PS3000_ETS_OFF,                        // ETS disabled
+  PS3000_ETS_FAST,                       // Return ready as soon as requested no of interleaves is available
+  PS3000_ETS_SLOW,                        // Return ready every time a new set of no_of_cycles is collected
+  PS3000_ETS_MODES_MAX
+  }  PS3000_ETS_MODE;
+
+typedef int16_t (PREF4 *PS3000_CALLBACK_FUNC)
+(
+  int16_t *dataBuffer,
+  int16_t  noOfBuffers
+);
+
+typedef void (PREF4 *GetOverviewBuffersMaxMin)
+(
+  int16_t **overviewBuffers,
+  int16_t   overflow,
+  uint32_t  triggeredAt,
+  int16_t   triggered,
+  int16_t   auto_stop,
+  uint32_t  nValues
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_open_unit)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_get_unit_info)
+(
+  int16_t  handle,
+  int8_t  *string,
+  int16_t  string_length,
+  int16_t  line
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_flash_led)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_close_unit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_set_channel)
+(
+  int16_t  handle,
+  int16_t  channel,
+  int16_t  enabled,
+  int16_t  dc,
+  int16_t  range
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_get_timebase)
+(
+  int16_t  handle,
+  int16_t  timebase,
+  int32_t  no_of_samples,
+  int32_t *time_interval,
+  int16_t *time_units,
+  int16_t  oversample,
+  int32_t *max_samples
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps3000_set_siggen)
+(
+  int16_t  handle,
+  int16_t  wave_type,
+  int32_t  start_frequency,
+  int32_t  stop_frequency,
+  float    increment,
+  int16_t  dwell_time,
+  int16_t  repeat,
+  int16_t  dual_slope
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps3000_set_ets)
+(
+  int16_t  handle,
+  int16_t  mode,
+  int16_t  ets_cycles,
+  int16_t  ets_interleave
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_set_trigger)
+(
+  int16_t  handle,
+  int16_t  source,
+  int16_t  threshold,
+  int16_t  direction,
+  int16_t  delay,
+  int16_t  auto_trigger_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_set_trigger2)
+(
+  int16_t  handle,
+  int16_t  source,
+  int16_t  threshold,
+  int16_t  direction,
+  float    delay,
+  int16_t  auto_trigger_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_run_block)
+(
+  int16_t handle,
+  int32_t  no_of_values,
+  int16_t  timebase,
+  int16_t  oversample,
+  int32_t * time_indisposed_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_run_streaming_ns)
+(
+  int16_t            handle,
+  uint32_t           sample_interval,
+  PS3000_TIME_UNITS  time_units,
+  uint32_t           max_samples,
+  int16_t            auto_stop,
+  uint32_t           noOfSamplesPerAggregate,
+  uint32_t           overview_buffer_size
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_run_streaming)
+(
+  int16_t  handle,
+  int16_t  sample_interval_ms,
+  int32_t  max_samples,
+  int16_t  windowed
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_ready)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_stop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps3000_get_values)
+(
+  int16_t  handle,
+  int16_t *buffer_a,
+  int16_t *buffer_b,
+  int16_t *buffer_c,
+  int16_t *buffer_d,
+  int16_t *overflow,
+  int32_t  no_of_values
+);
+
+PREF0 PREF1 void PREF2 PREF3 (ps3000_release_stream_buffer)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps3000_get_times_and_values)
+(
+  int16_t  handle,
+  int32_t *times,
+  int16_t *buffer_a,
+  int16_t *buffer_b,
+  int16_t *buffer_c,
+  int16_t *buffer_d,
+  int16_t *overflow,
+  int16_t  time_units,
+  int32_t  no_of_values
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_open_unit_async)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_open_unit_progress)
+(
+  int16_t *handle,
+  int16_t * progress_percent
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_streaming_ns_get_interval_stateless)
+(
+  int16_t   handle,
+  int16_t   nChannels,
+  uint32_t *sample_interval
+  );
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_get_streaming_last_values)
+(
+  int16_t                   handle,
+  GetOverviewBuffersMaxMin  lpGetOverviewBuffersMaxMin
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000_overview_buffer_status)
+(
+  int16_t  handle,
+  int16_t *previous_buffer_overrun
+);
+
+PREF0 PREF1 uint32_t PREF2 PREF3(ps3000_get_streaming_values)
+(
+  int16_t handle,
+  double *start_time,
+  int16_t  *pbuffer_a_max,
+  int16_t  *pbuffer_a_min,
+  int16_t  *pbuffer_b_max,
+  int16_t  *pbuffer_b_min,
+  int16_t  *pbuffer_c_max,
+  int16_t  *pbuffer_c_min,
+  int16_t  *pbuffer_d_max,
+  int16_t  *pbuffer_d_min,
+  int16_t  *overflow,
+  uint32_t *triggerAt,
+  int16_t  *triggered,
+  uint32_t  no_of_values,
+  uint32_t  noOfSamplesPerAggregate
+);
+
+PREF0 PREF1 uint32_t PREF2 PREF3 (ps3000_get_streaming_values_no_aggregation)
+(
+  int16_t   handle,
+  double   *start_time,
+  int16_t  *pbuffer_a,
+  int16_t  *pbuffer_b,
+  int16_t  *pbuffer_c,
+  int16_t  *pbuffer_d,
+  int16_t  *overflow,
+  uint32_t *triggerAt,
+  int16_t  *trigger,
+  uint32_t  no_of_values
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000_save_streaming_data)
+(
+  int16_t               handle,
+  PS3000_CALLBACK_FUNC  lpCallbackFunc,
+  int16_t              *dataBuffers,
+  int16_t               dataBufferSize
+);
+
+//===========================================================
+// Adv Trigger
+//===========================================================
+typedef enum enThresholdDirection
+{
+  ABOVE,
+  BELOW,
+  RISING,
+  FALLING,
+  RISING_OR_FALLING,
+  INSIDE = ABOVE,
+  OUTSIDE = BELOW,
+  ENTER = RISING,
+  EXIT = FALLING,
+  ENTER_OR_EXIT = RISING_OR_FALLING,
+  NONE = RISING
+} THRESHOLD_DIRECTION;
+
+typedef enum enThresholdMode
+{
+  LEVEL,
+  WINDOW
+} THRESHOLD_MODE;
+
+typedef enum enTriggerState
+{
+  CONDITION_DONT_CARE,
+  CONDITION_TRUE,
+  CONDITION_FALSE,
+  CONDITION_MAX
+} TRIGGER_STATE;
+
+typedef enum enPulseWidthType
+{
+  PW_TYPE_NONE,
+  PW_TYPE_LESS_THAN,
+  PW_TYPE_GREATER_THAN,
+  PW_TYPE_IN_RANGE,
+  PW_TYPE_OUT_OF_RANGE
+} PULSE_WIDTH_TYPE;
+
+#pragma pack(1)
+typedef struct tTriggerChannelProperties
+{
+  int16_t thresholdMajor;
+  int16_t thresholdMinor;
+  uint16_t hysteresis;
+  int16_t channel;
+  THRESHOLD_MODE thresholdMode;
+} TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tTriggerConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+  TRIGGER_STATE pulseWidthQualifier;
+} TRIGGER_CONDITIONS;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tPwqConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+} PWQ_CONDITIONS;
+#pragma pack()
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000SetAdvTriggerChannelProperties)
+(
+  int16_t                     handle,
+  TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                     nChannelProperties,
+  int32_t                     autoTriggerMilliseconds
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000SetAdvTriggerChannelConditions)
+(
+  int16_t              handle,
+  TRIGGER_CONDITIONS  *conditions,
+  int16_t              nConditions
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000SetAdvTriggerChannelDirections)
+(
+  int16_t              handle,
+  THRESHOLD_DIRECTION  channelA,
+  THRESHOLD_DIRECTION  channelB,
+  THRESHOLD_DIRECTION  channelC,
+  THRESHOLD_DIRECTION  channelD,
+  THRESHOLD_DIRECTION  ext
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000SetPulseWidthQualifier)
+(
+  int16_t              handle,
+  PWQ_CONDITIONS      *conditions,
+  int16_t              nConditions,
+  THRESHOLD_DIRECTION  direction,
+  uint32_t             lower,
+  uint32_t             upper,
+  PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000SetAdvTriggerDelay)
+(
+  int16_t   handle,
+  uint32_t  delay,
+  float     preTriggerDelay
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000PingUnit)
+  (
+  int16_t  handle
+  );
+
+#endif /* not defined PS3000_H */

+ 1142 - 0
pico-tcp-service/pico-tcp-client/inc/ps3000aApi.h

@@ -0,0 +1,1142 @@
+/****************************************************************************
+ *
+ * Filename:    ps3000aApi.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *	PicoScope 3000A, B and D Series PC Oscilloscopes.
+ *
+ * Copyright � 2010 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS3000AAPI_H__
+#define __PS3000AAPI_H__
+
+#include <stdint.h>
+
+#include "PicoCallback.h"
+#include "PicoStatus.h"
+#include "PicoVersion.h"
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+  #define TYPE_ENUM
+#else
+  #define PREF0
+  #define TYPE_ENUM enum
+#endif
+
+#ifdef WIN32
+  #ifdef PREF1
+    #undef PREF1
+  #endif
+  #ifdef PREF2
+    #undef PREF2
+  #endif
+  #ifdef PREF3
+    #undef PREF3
+  #endif
+  //If you are dynamically linking ps3000a.dll into your project #define DYNLINK here
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define __stdcall
+#endif
+
+#define PS3000A_MAX_OVERSAMPLE  256
+
+/* Depending on the adc;oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+
+#define PS3207A_MAX_ETS_CYCLES  500
+#define PS3207A_MAX_INTERLEAVE   40
+
+#define PS3206A_MAX_ETS_CYCLES  500
+#define PS3206A_MAX_INTERLEAVE   40
+#define PS3206MSO_MAX_INTERLEAVE 80
+
+#define PS3205A_MAX_ETS_CYCLES  250
+#define PS3205A_MAX_INTERLEAVE   20
+#define PS3205MSO_MAX_INTERLEAVE 40
+
+#define PS3204A_MAX_ETS_CYCLES  125
+#define PS3204A_MAX_INTERLEAVE   10
+#define PS3204MSO_MAX_INTERLEAVE 20
+
+#define PS3000A_EXT_MAX_VALUE  32767
+#define PS3000A_EXT_MIN_VALUE -32767
+
+#define PS3000A_MAX_LOGIC_LEVEL  32767
+#define PS3000A_MIN_LOGIC_LEVEL -32767
+
+#define MIN_SIG_GEN_FREQ 0.0f
+#define MAX_SIG_GEN_FREQ 20000000.0f
+
+#define PS3207B_MAX_SIG_GEN_BUFFER_SIZE 32768
+#define PS3206B_MAX_SIG_GEN_BUFFER_SIZE 16384
+#define MAX_SIG_GEN_BUFFER_SIZE         8192
+#define MIN_SIG_GEN_BUFFER_SIZE         1
+#define MIN_DWELL_COUNT                 3
+#define MAX_SWEEPS_SHOTS       ((1 << 30) - 1)
+
+#define MAX_ANALOGUE_OFFSET_50MV_200MV  0.250f
+#define MIN_ANALOGUE_OFFSET_50MV_200MV -0.250f
+#define MAX_ANALOGUE_OFFSET_500MV_2V    2.500f
+#define MIN_ANALOGUE_OFFSET_500MV_2V   -2.500f
+#define MAX_ANALOGUE_OFFSET_5V_20V        20.f
+#define MIN_ANALOGUE_OFFSET_5V_20V       -20.f
+
+#define PS3000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN 0xFFFFFFFF
+
+typedef enum enPS3000ABandwidthLimiter
+{
+  PS3000A_BW_FULL,
+  PS3000A_BW_20MHZ,
+} PS3000A_BANDWIDTH_LIMITER;
+
+typedef enum enPS3000AChannelBufferIndex
+{
+  PS3000A_CHANNEL_A_MAX,
+  PS3000A_CHANNEL_A_MIN,
+  PS3000A_CHANNEL_B_MAX,
+  PS3000A_CHANNEL_B_MIN,
+  PS3000A_CHANNEL_C_MAX,
+  PS3000A_CHANNEL_C_MIN,
+  PS3000A_CHANNEL_D_MAX,
+  PS3000A_CHANNEL_D_MIN,
+  PS3000A_MAX_CHANNEL_BUFFERS
+} PS3000A_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS3000AChannel
+{
+  PS3000A_CHANNEL_A,
+  PS3000A_CHANNEL_B,
+  PS3000A_CHANNEL_C,
+  PS3000A_CHANNEL_D,
+  PS3000A_EXTERNAL,
+  PS3000A_MAX_CHANNELS = PS3000A_EXTERNAL,
+  PS3000A_TRIGGER_AUX,
+  PS3000A_MAX_TRIGGER_SOURCES
+} PS3000A_CHANNEL;
+
+typedef enum enPS3000ADigitalPort
+{
+  PS3000A_DIGITAL_PORT0 = 0x80, // digital channel 0 - 7
+  PS3000A_DIGITAL_PORT1,             // digital channel 8 - 15
+  PS3000A_DIGITAL_PORT2,             // digital channel 16 - 23
+  PS3000A_DIGITAL_PORT3,             // digital channel 24 - 31
+  PS3000A_MAX_DIGITAL_PORTS = (PS3000A_DIGITAL_PORT3 - PS3000A_DIGITAL_PORT0) + 1
+} PS3000A_DIGITAL_PORT;
+
+typedef enum enPS3000ADigitalChannel
+{
+  PS3000A_DIGITAL_CHANNEL_0,
+  PS3000A_DIGITAL_CHANNEL_1,
+  PS3000A_DIGITAL_CHANNEL_2,
+  PS3000A_DIGITAL_CHANNEL_3,
+  PS3000A_DIGITAL_CHANNEL_4,
+  PS3000A_DIGITAL_CHANNEL_5,
+  PS3000A_DIGITAL_CHANNEL_6,
+  PS3000A_DIGITAL_CHANNEL_7,
+  PS3000A_DIGITAL_CHANNEL_8,
+  PS3000A_DIGITAL_CHANNEL_9,
+  PS3000A_DIGITAL_CHANNEL_10,
+  PS3000A_DIGITAL_CHANNEL_11,
+  PS3000A_DIGITAL_CHANNEL_12,
+  PS3000A_DIGITAL_CHANNEL_13,
+  PS3000A_DIGITAL_CHANNEL_14,
+  PS3000A_DIGITAL_CHANNEL_15,
+  PS3000A_DIGITAL_CHANNEL_16,
+  PS3000A_DIGITAL_CHANNEL_17,
+  PS3000A_DIGITAL_CHANNEL_18,
+  PS3000A_DIGITAL_CHANNEL_19,
+  PS3000A_DIGITAL_CHANNEL_20,
+  PS3000A_DIGITAL_CHANNEL_21,
+  PS3000A_DIGITAL_CHANNEL_22,
+  PS3000A_DIGITAL_CHANNEL_23,
+  PS3000A_DIGITAL_CHANNEL_24,
+  PS3000A_DIGITAL_CHANNEL_25,
+  PS3000A_DIGITAL_CHANNEL_26,
+  PS3000A_DIGITAL_CHANNEL_27,
+  PS3000A_DIGITAL_CHANNEL_28,
+  PS3000A_DIGITAL_CHANNEL_29,
+  PS3000A_DIGITAL_CHANNEL_30,
+  PS3000A_DIGITAL_CHANNEL_31,
+  PS3000A_MAX_DIGITAL_CHANNELS
+} PS3000A_DIGITAL_CHANNEL;
+
+typedef enum enPS3000ARange
+{
+  PS3000A_10MV,
+  PS3000A_20MV,
+  PS3000A_50MV,
+  PS3000A_100MV,
+  PS3000A_200MV,
+  PS3000A_500MV,
+  PS3000A_1V,
+  PS3000A_2V,
+  PS3000A_5V,
+  PS3000A_10V,
+  PS3000A_20V,
+  PS3000A_50V,
+  PS3000A_MAX_RANGES,
+} PS3000A_RANGE;
+
+typedef enum enPS3000ACoupling
+{
+  PS3000A_AC,
+  PS3000A_DC
+} PS3000A_COUPLING;
+
+typedef enum enPS3000AChannelInfo
+{
+  PS3000A_CI_RANGES,
+} PS3000A_CHANNEL_INFO;
+
+typedef enum enPS3000AEtsMode
+{
+  PS3000A_ETS_OFF, // ETS disabled
+  PS3000A_ETS_FAST,
+  PS3000A_ETS_SLOW,
+  PS3000A_ETS_MODES_MAX
+} PS3000A_ETS_MODE;
+
+typedef enum enPS3000ATimeUnits
+{
+  PS3000A_FS,
+  PS3000A_PS,
+  PS3000A_NS,
+  PS3000A_US,
+  PS3000A_MS,
+  PS3000A_S,
+  PS3000A_MAX_TIME_UNITS,
+} PS3000A_TIME_UNITS;
+
+typedef enum enPS3000ASweepType
+{
+  PS3000A_UP,
+  PS3000A_DOWN,
+  PS3000A_UPDOWN,
+  PS3000A_DOWNUP,
+  PS3000A_MAX_SWEEP_TYPES
+} PS3000A_SWEEP_TYPE;
+
+typedef enum enPS3000AWaveType
+{
+  PS3000A_SINE,
+  PS3000A_SQUARE,
+  PS3000A_TRIANGLE,
+  PS3000A_RAMP_UP,
+  PS3000A_RAMP_DOWN,
+  PS3000A_SINC,
+  PS3000A_GAUSSIAN,
+  PS3000A_HALF_SINE,
+  PS3000A_DC_VOLTAGE,
+  PS3000A_MAX_WAVE_TYPES
+} PS3000A_WAVE_TYPE;
+
+typedef enum enPS3000AExtraOperations
+{
+  PS3000A_ES_OFF,
+  PS3000A_WHITENOISE,
+  PS3000A_PRBS // Pseudo-Random Bit Stream
+} PS3000A_EXTRA_OPERATIONS;
+
+#define PS3000A_SINE_MAX_FREQUENCY       1000000.f
+#define PS3000A_SQUARE_MAX_FREQUENCY     1000000.f
+#define PS3000A_TRIANGLE_MAX_FREQUENCY   1000000.f
+#define PS3000A_SINC_MAX_FREQUENCY       1000000.f
+#define PS3000A_RAMP_MAX_FREQUENCY       1000000.f
+#define PS3000A_HALF_SINE_MAX_FREQUENCY  1000000.f
+#define PS3000A_GAUSSIAN_MAX_FREQUENCY   1000000.f
+#define PS3000A_PRBS_MAX_FREQUENCY       1000000.f
+#define PS3000A_PRBS_MIN_FREQUENCY           0.03f
+#define PS3000A_MIN_FREQUENCY                0.03f
+
+typedef enum enPS3000ASigGenTrigType
+{
+  PS3000A_SIGGEN_RISING,
+  PS3000A_SIGGEN_FALLING,
+  PS3000A_SIGGEN_GATE_HIGH,
+  PS3000A_SIGGEN_GATE_LOW
+} PS3000A_SIGGEN_TRIG_TYPE;
+
+typedef enum enPS3000ASigGenTrigSource
+{
+  PS3000A_SIGGEN_NONE,
+  PS3000A_SIGGEN_SCOPE_TRIG,
+  PS3000A_SIGGEN_AUX_IN,
+  PS3000A_SIGGEN_EXT_IN,
+  PS3000A_SIGGEN_SOFT_TRIG
+} PS3000A_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPS3000AIndexMode
+{
+  PS3000A_SINGLE,
+  PS3000A_DUAL,
+  PS3000A_QUAD,
+  PS3000A_MAX_INDEX_MODES
+} PS3000A_INDEX_MODE;
+
+typedef enum enPS3000A_ThresholdMode
+{
+  PS3000A_LEVEL,
+  PS3000A_WINDOW
+} PS3000A_THRESHOLD_MODE;
+
+typedef enum enPS3000AThresholdDirection
+{
+  PS3000A_ABOVE,             //using upper threshold
+  PS3000A_BELOW,						 //using upper threshold
+  PS3000A_RISING,            // using upper threshold
+  PS3000A_FALLING,           // using upper threshold
+  PS3000A_RISING_OR_FALLING, // using both threshold
+  PS3000A_ABOVE_LOWER,       // using lower threshold
+  PS3000A_BELOW_LOWER,       // using lower threshold
+  PS3000A_RISING_LOWER,      // using lower threshold
+  PS3000A_FALLING_LOWER,     // using lower threshold
+  // Windowing using both thresholds
+  PS3000A_INSIDE        = PS3000A_ABOVE,
+  PS3000A_OUTSIDE       = PS3000A_BELOW,
+  PS3000A_ENTER         = PS3000A_RISING,
+  PS3000A_EXIT          = PS3000A_FALLING,
+  PS3000A_ENTER_OR_EXIT = PS3000A_RISING_OR_FALLING,
+  PS3000A_POSITIVE_RUNT = 9,
+  PS3000A_NEGATIVE_RUNT,
+  // no trigger set
+  PS3000A_NONE = PS3000A_RISING
+} PS3000A_THRESHOLD_DIRECTION;
+
+typedef enum enPS3000ADigitalDirection
+{
+  PS3000A_DIGITAL_DONT_CARE,
+  PS3000A_DIGITAL_DIRECTION_LOW,
+  PS3000A_DIGITAL_DIRECTION_HIGH,
+  PS3000A_DIGITAL_DIRECTION_RISING,
+  PS3000A_DIGITAL_DIRECTION_FALLING,
+  PS3000A_DIGITAL_DIRECTION_RISING_OR_FALLING,
+  PS3000A_DIGITAL_MAX_DIRECTION
+} PS3000A_DIGITAL_DIRECTION;
+
+typedef enum enPS3000ATriggerState
+{
+  PS3000A_CONDITION_DONT_CARE,
+  PS3000A_CONDITION_TRUE,
+  PS3000A_CONDITION_FALSE,
+  PS3000A_CONDITION_MAX
+} PS3000A_TRIGGER_STATE;
+
+#pragma pack(push,1)
+typedef struct tPS3000ATriggerConditions
+{
+  PS3000A_TRIGGER_STATE channelA;
+  PS3000A_TRIGGER_STATE channelB;
+  PS3000A_TRIGGER_STATE channelC;
+  PS3000A_TRIGGER_STATE channelD;
+  PS3000A_TRIGGER_STATE external;
+  PS3000A_TRIGGER_STATE aux;
+  PS3000A_TRIGGER_STATE pulseWidthQualifier;
+} PS3000A_TRIGGER_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000ATriggerConditionsV2
+{
+  PS3000A_TRIGGER_STATE channelA;
+  PS3000A_TRIGGER_STATE channelB;
+  PS3000A_TRIGGER_STATE channelC;
+  PS3000A_TRIGGER_STATE channelD;
+  PS3000A_TRIGGER_STATE external;
+  PS3000A_TRIGGER_STATE aux;
+  PS3000A_TRIGGER_STATE pulseWidthQualifier;
+  PS3000A_TRIGGER_STATE digital;
+} PS3000A_TRIGGER_CONDITIONS_V2;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000APwqConditions
+{
+  PS3000A_TRIGGER_STATE channelA;
+  PS3000A_TRIGGER_STATE channelB;
+  PS3000A_TRIGGER_STATE channelC;
+  PS3000A_TRIGGER_STATE channelD;
+  PS3000A_TRIGGER_STATE external;
+  PS3000A_TRIGGER_STATE aux;
+} PS3000A_PWQ_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000APwqConditionsV2
+{
+  PS3000A_TRIGGER_STATE channelA;
+  PS3000A_TRIGGER_STATE channelB;
+  PS3000A_TRIGGER_STATE channelC;
+  PS3000A_TRIGGER_STATE channelD;
+  PS3000A_TRIGGER_STATE external;
+  PS3000A_TRIGGER_STATE aux;
+  PS3000A_TRIGGER_STATE digital;
+} PS3000A_PWQ_CONDITIONS_V2;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000ADigitalChannelDirections
+{
+  PS3000A_DIGITAL_CHANNEL   channel;
+  PS3000A_DIGITAL_DIRECTION direction;
+} PS3000A_DIGITAL_CHANNEL_DIRECTIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000ATriggerChannelProperties
+{
+  int16_t                   thresholdUpper;
+  uint16_t          thresholdUpperHysteresis;
+  int16_t                   thresholdLower;
+  uint16_t          thresholdLowerHysteresis;
+  PS3000A_CHANNEL         channel;
+  PS3000A_THRESHOLD_MODE  thresholdMode;
+} PS3000A_TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000ATriggerInfo
+{
+	PICO_STATUS		status;
+	uint32_t		segmentIndex;
+	uint32_t		reserved0;
+	int64_t			triggerTime;
+	int16_t			timeUnits;
+	int16_t			reserved1;
+	uint64_t		timeStampCounter;
+} PS3000A_TRIGGER_INFO;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000AScalingFactors
+{
+	PS3000A_CHANNEL channelOrPort;
+	PS3000A_RANGE   range;
+	int16_t         offset;
+	double          scalingFactor;
+}PS3000A_SCALING_FACTORS_VALUES;
+#pragma pack(pop)
+
+typedef enum enPS3000ARatioMode
+{
+  PS3000A_RATIO_MODE_NONE,
+  PS3000A_RATIO_MODE_AGGREGATE = 1,
+  PS3000A_RATIO_MODE_DECIMATE  = 2,
+  PS3000A_RATIO_MODE_AVERAGE   = 4,
+} PS3000A_RATIO_MODE;
+
+typedef enum enPS3000APulseWidthType
+{
+  PS3000A_PW_TYPE_NONE,
+  PS3000A_PW_TYPE_LESS_THAN,
+  PS3000A_PW_TYPE_GREATER_THAN,
+  PS3000A_PW_TYPE_IN_RANGE,
+  PS3000A_PW_TYPE_OUT_OF_RANGE
+} PS3000A_PULSE_WIDTH_TYPE;
+
+typedef enum enPS3000AHoldOffType
+{
+  PS3000A_TIME,
+  PS3000A_EVENT,
+  PS3000A_MAX_HOLDOFF_TYPE
+} PS3000A_HOLDOFF_TYPE;
+
+typedef void (__stdcall *ps3000aBlockReady)
+(
+  int16_t       handle,
+  PICO_STATUS status,
+  void       *pParameter
+);
+
+typedef void (__stdcall *ps3000aStreamingReady)
+(
+  int16_t          handle,
+  int32_t           noOfSamples,
+  uint32_t  startIndex,
+  int16_t          overflow,
+  uint32_t  triggerAt,
+  int16_t          triggered,
+  int16_t          autoStop,
+  void          *pParameter
+);
+
+typedef void (__stdcall *ps3000aDataReady)
+(
+  int16_t          handle,
+  PICO_STATUS    status,
+  uint32_t  noOfSamples,
+  int16_t          overflow,
+  void          *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aOpenUnit)
+(
+  int16_t *handle,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aOpenUnitAsync)
+(
+  int16_t *status,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aOpenUnitProgress)
+(
+  int16_t *handle,
+  int16_t *progressPercent,
+  int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetUnitInfo)
+ (
+  int16_t      handle,
+  int8_t      *string,
+  int16_t      stringLength,
+  int16_t     *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aFlashLed)
+(
+  int16_t  handle,
+  int16_t  start
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aCloseUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aMemorySegments)
+(
+  int16_t           handle,
+  uint32_t  nSegments,
+  int32_t           *nMaxSamples
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetChannel)
+(
+  int16_t             handle,
+  PS3000A_CHANNEL   channel,
+  int16_t             enabled,
+  PS3000A_COUPLING  type,
+  PS3000A_RANGE     range,
+  float             analogOffset
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetDigitalPort)
+(
+  int16_t                 handle,
+  PS3000A_DIGITAL_PORT  port,
+  int16_t                 enabled,
+  int16_t                 logicLevel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetBandwidthFilter)
+(
+  int16_t                      handle,
+  PS3000A_CHANNEL            channel,
+  PS3000A_BANDWIDTH_LIMITER  bandwidth
+);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetNoOfCaptures)
+(
+  int16_t           handle,
+  uint32_t  nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetTimebase)
+(
+  int16_t           handle,
+  uint32_t   timebase,
+  int32_t            noSamples,
+  int32_t           *timeIntervalNanoseconds,
+  int16_t           oversample,
+  int32_t           *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetTimebase2)
+(
+  int16_t           handle,
+  uint32_t   timebase,
+  int32_t            noSamples,
+  float          *timeIntervalNanoseconds,
+  int16_t           oversample,
+  int32_t           *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetSigGenArbitrary)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  uint32_t               startDeltaPhase,
+  uint32_t               stopDeltaPhase,
+  uint32_t               deltaPhaseIncrement,
+  uint32_t               dwellCount,
+  int16_t                      *arbitraryWaveform,
+  int32_t                        arbitraryWaveformSize,
+  PS3000A_SWEEP_TYPE          sweepType,
+  PS3000A_EXTRA_OPERATIONS    operation,
+  PS3000A_INDEX_MODE          indexMode,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS3000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS3000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSetSigGenBuiltIn)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  int16_t                       waveType,
+  float                       startFrequency,
+  float                       stopFrequency,
+  float                       increment,
+  float                       dwellTime,
+  PS3000A_SWEEP_TYPE          sweepType,
+  PS3000A_EXTRA_OPERATIONS    operation,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS3000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS3000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSetSigGenBuiltInV2)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  int16_t                       waveType,
+  double                       startFrequency,
+  double                       stopFrequency,
+	double											 increment,
+  double                       dwellTime,
+  PS3000A_SWEEP_TYPE          sweepType,
+  PS3000A_EXTRA_OPERATIONS    operation,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS3000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS3000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetSigGenPropertiesArbitrary)
+(
+  int16_t                       handle,
+  uint32_t               startDeltaPhase,
+  uint32_t               stopDeltaPhase,
+  uint32_t               deltaPhaseIncrement,
+  uint32_t               dwellCount,
+  PS3000A_SWEEP_TYPE          sweepType,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS3000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS3000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSetSigGenPropertiesBuiltIn)
+(
+  int16_t                       handle,
+  double                       startFrequency,
+  double                       stopFrequency,
+  double                       increment,
+  double                       dwellTime,
+  PS3000A_SWEEP_TYPE          sweepType,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS3000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS3000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	PS3000A_INDEX_MODE						indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aGetMaxEtsValues)
+	(
+	int16_t			 handle,
+	int16_t    * etsCycles,
+	int16_t    * etsInterleave
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSigGenSoftwareControl)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetEts)
+(
+  int16_t             handle,
+  PS3000A_ETS_MODE  mode,
+  int16_t             etsCycles,
+  int16_t             etsInterleave,
+  int32_t             *sampleTimePicoseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetSimpleTrigger)
+(
+  int16_t                        handle,
+  int16_t                        enable,
+  PS3000A_CHANNEL              source,
+  int16_t                        threshold,
+  PS3000A_THRESHOLD_DIRECTION  direction,
+  uint32_t                delay,
+  int16_t                        autoTrigger_ms
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerDigitalPortProperties)
+(
+  int16_t                               handle,
+  PS3000A_DIGITAL_CHANNEL_DIRECTIONS *directions,
+  int16_t                               nDirections
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetPulseWidthDigitalPortProperties)
+	(
+	int16_t                               handle,
+	PS3000A_DIGITAL_CHANNEL_DIRECTIONS *directions,
+	int16_t                               nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerChannelProperties)
+(
+  int16_t                               handle,
+  PS3000A_TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                               nChannelProperties,
+  int16_t                               auxOutputEnable,
+  int32_t                                autoTriggerMilliseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerChannelConditions)
+(
+  int16_t                       handle,
+  PS3000A_TRIGGER_CONDITIONS *conditions,
+  int16_t                       nConditions
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerChannelConditionsV2)
+(
+  int16_t                          handle,
+  PS3000A_TRIGGER_CONDITIONS_V2 *conditions,
+  int16_t                          nConditions
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerChannelDirections)
+(
+  int16_t                        handle,
+  PS3000A_THRESHOLD_DIRECTION  channelA,
+  PS3000A_THRESHOLD_DIRECTION  channelB,
+  PS3000A_THRESHOLD_DIRECTION  channelC,
+  PS3000A_THRESHOLD_DIRECTION  channelD,
+  PS3000A_THRESHOLD_DIRECTION  ext,
+  PS3000A_THRESHOLD_DIRECTION  aux
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerDelay)
+(
+  int16_t          handle,
+  uint32_t  delay
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetPulseWidthQualifier)
+(
+  int16_t                        handle,
+  PS3000A_PWQ_CONDITIONS      *conditions,
+  int16_t                        nConditions,
+  PS3000A_THRESHOLD_DIRECTION  direction,
+  uint32_t                lower,
+  uint32_t                upper,
+  PS3000A_PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetPulseWidthQualifierV2)
+(
+  int16_t                        handle,
+  PS3000A_PWQ_CONDITIONS_V2   *conditions,
+  int16_t                        nConditions,
+  PS3000A_THRESHOLD_DIRECTION  direction,
+  uint32_t                lower,
+  uint32_t                upper,
+  PS3000A_PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aIsTriggerOrPulseWidthQualifierEnabled)
+(
+  int16_t  handle,
+  int16_t *triggerEnabled,
+  int16_t *pulseWidthQualifierEnabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetTriggerTimeOffset)
+(
+  int16_t               handle,
+  uint32_t      *timeUpper,
+  uint32_t      *timeLower,
+  PS3000A_TIME_UNITS *timeUnits,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetTriggerTimeOffset64)
+(
+  int16_t               handle,
+  int64_t            *time,
+  PS3000A_TIME_UNITS *timeUnits,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesTriggerTimeOffsetBulk)
+(
+  int16_t               handle,
+  uint32_t      *timesUpper,
+  uint32_t      *timesLower,
+  PS3000A_TIME_UNITS *timeUnits,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesTriggerTimeOffsetBulk64)
+(
+  int16_t               handle,
+  int64_t            *times,
+  PS3000A_TIME_UNITS *timeUnits,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetNoOfCaptures)
+(
+  int16_t          handle,
+  uint32_t *nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetNoOfProcessedCaptures)
+(
+  int16_t          handle,
+  uint32_t *nProcessedCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetDataBuffer)
+(
+  int16_t               handle,
+  PS3000A_CHANNEL     channelOrPort,
+  int16_t              *buffer,
+  int32_t                bufferLth,
+  uint32_t      segmentIndex,
+  PS3000A_RATIO_MODE  mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetDataBuffers)
+(
+  int16_t               handle,
+  PS3000A_CHANNEL     channelOrPort,
+  int16_t              *bufferMax,
+  int16_t              *bufferMin,
+  int32_t                bufferLth,
+  uint32_t      segmentIndex,
+  PS3000A_RATIO_MODE  mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSetUnscaledDataBuffers)
+(
+	int16_t               handle,
+	PS3000A_CHANNEL     channelOrPort,
+	int8_t              *bufferMax,
+	int8_t              *bufferMin,
+	int32_t                bufferLth,
+	uint32_t      segmentIndex,
+	PS3000A_RATIO_MODE  mode
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetEtsTimeBuffer)
+(
+  int16_t    handle,
+  int64_t *buffer,
+  int32_t     bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetEtsTimeBuffers)
+(
+  int16_t          handle,
+  uint32_t *timeUpper,
+  uint32_t *timeLower,
+  int32_t           bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aIsReady)
+(
+  int16_t  handle,
+  int16_t *ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aRunBlock)
+(
+  int16_t              handle,
+  int32_t               noOfPreTriggerSamples,
+  int32_t               noOfPostTriggerSamples,
+  uint32_t      timebase,
+  int16_t              oversample,
+  int32_t              *timeIndisposedMs,
+  uint32_t     segmentIndex,
+  ps3000aBlockReady  lpReady,
+  void              *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aRunStreaming)
+(
+  int16_t               handle,
+  uint32_t      *sampleInterval,
+  PS3000A_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t       maxPreTriggerSamples,
+  uint32_t       maxPostPreTriggerSamples,
+  int16_t               autoStop,
+  uint32_t       downSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetStreamingLatestValues)
+(
+int16_t                  handle,
+ps3000aStreamingReady  lpPs3000aReady,
+void                  *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aNoOfStreamingValues)
+(
+  int16_t          handle,
+  uint32_t *noOfValues
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetMaxDownSampleRatio)
+(
+  int16_t               handle,
+  uint32_t       noOfUnaggreatedSamples,
+  uint32_t      *maxDownSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValues)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesBulk)
+(
+ int16_t                handle,
+  uint32_t      *noOfSamples,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex,
+  uint32_t       downSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesAsync)
+(
+  int16_t           handle,
+  uint32_t   startIndex,
+  uint32_t   noOfSamples,
+  uint32_t   downSampleRatio,
+  PS3000A_RATIO_MODE   downSampleRatioMode,
+  uint32_t  segmentIndex,
+  void           *lpDataReady,
+  void           *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesOverlapped)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex,
+  int16_t              *overflow
+);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesOverlappedBulk)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetTriggerInfoBulk)
+(
+	int16_t									handle,
+  PS3000A_TRIGGER_INFO	*	triggerInfo,
+  uint32_t								fromSegmentIndex,
+  uint32_t								toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aStop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aHoldOff)
+(
+  int16_t                 handle,
+  uint64_t             holdoff,
+  PS3000A_HOLDOFF_TYPE  type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetChannelInformation)
+(
+  int16_t                 handle,
+  PS3000A_CHANNEL_INFO  info,
+  int32_t                   probe,
+  int32_t                  *ranges,
+  int32_t                  *length,
+  int32_t                   channels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aEnumerateUnits)
+(
+  int16_t *count,
+  int8_t  *serials,
+  int16_t *serialLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aPingUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aMaximumValue)
+(
+  int16_t  handle,
+  int16_t *value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aMinimumValue)
+(
+  int16_t  handle,
+  int16_t *value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetAnalogueOffset)
+(
+  int16_t             handle,
+  PS3000A_RANGE     range,
+  PS3000A_COUPLING  coupling,
+  float            *maximumVoltage,
+  float            *minimumVoltage
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetMaxSegments)
+(
+  int16_t           handle,
+  uint32_t *maxSegments
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aChangePowerSource)
+(
+  int16_t        handle,
+  PICO_STATUS  powerState
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aCurrentPowerSource)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aGetScalingValues)
+(
+	int16_t	handle,
+	PS3000A_SCALING_FACTORS_VALUES *scalingValues,
+	int16_t nChannels
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aCheckForUpdate)(int16_t handle,
+                                                           PICO_FIRMWARE_INFO* firmwareInfos,
+                                                           int16_t* nFirmwareInfos,
+                                                           uint16_t* updatesRequired);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aStartFirmwareUpdate)(int16_t handle, PicoUpdateFirmwareProgress progress);
+
+#endif

+ 979 - 0
pico-tcp-service/pico-tcp-client/inc/ps4000Api.h

@@ -0,0 +1,979 @@
+/****************************************************************************
+ *
+ * Filename:    ps4000Api.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 4000 Series PC Oscilloscopes.
+ *
+ * Copyright � 2008 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS4000API_H__
+#define __PS4000API_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+  #define TYPE_ENUM
+#else
+  #define PREF0
+  #define TYPE_ENUM enum
+#endif
+
+#ifdef WIN32
+  typedef uint64_t uint64_t;
+  #ifdef PREF1
+    #undef PREF1
+  #endif
+  #ifdef PREF2
+    #undef PREF2
+  #endif
+  #ifdef PREF3
+    #undef PREF3
+  #endif
+  /*  If you are dynamically linking ps4000.dll into your project #define DYNLINK here
+   */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define __stdcall
+#endif
+
+#define PS4000_MAX_OVERSAMPLE_12BIT  16
+#define PS4000_MAX_OVERSAMPLE_8BIT  256
+
+/* Depending on the adc; oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+
+#define PS4XXX_MAX_ETS_CYCLES 400
+#define PS4XXX_MAX_INTERLEAVE  80
+
+#define PS4262_MAX_VALUE  32767
+#define PS4262_MIN_VALUE -32767
+
+#define PS4000_MAX_VALUE  32764
+#define PS4000_MIN_VALUE -32764
+#define PS4000_LOST_DATA -32768
+
+#define PS4000_EXT_MAX_VALUE  32767
+#define PS4000_EXT_MIN_VALUE -32767
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+#define MAX_DELAY_COUNT 8388607L
+
+#define MIN_SIG_GEN_FREQ          0.0f
+#define MAX_SIG_GEN_FREQ     100000.0f
+#define MAX_SIG_GEN_FREQ_4262 20000.0f
+
+// applicable to all variants with a signal generator
+#define MIN_SIG_GEN_BUFFER_SIZE    1
+
+// values relate to the PS4227 and PS4226
+#define MAX_SIG_GEN_BUFFER_SIZE 8192
+#define MIN_DWELL_COUNT           10
+
+#define PS4262_MAX_WAVEFORM_BUFFER_SIZE 4096
+#define PS4262_MIN_DWELL_COUNT             3
+
+#define MAX_SWEEPS_SHOTS     ((1 << 30) - 1)
+
+typedef enum enChannelBufferIndex
+{
+  PS4000_CHANNEL_A_MAX,
+  PS4000_CHANNEL_A_MIN,
+  PS4000_CHANNEL_B_MAX,
+  PS4000_CHANNEL_B_MIN,
+  PS4000_CHANNEL_C_MAX,
+  PS4000_CHANNEL_C_MIN,
+  PS4000_CHANNEL_D_MAX,
+  PS4000_CHANNEL_D_MIN,
+  PS4000_MAX_CHANNEL_BUFFERS
+} PS4000_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS4000Channel
+{
+  PS4000_CHANNEL_A,
+  PS4000_CHANNEL_B,
+  PS4000_CHANNEL_C,
+  PS4000_CHANNEL_D,
+  PS4000_EXTERNAL,
+  PS4000_MAX_CHANNELS = PS4000_EXTERNAL,
+  PS4000_TRIGGER_AUX,
+  PS4000_MAX_TRIGGER_SOURCES
+}  PS4000_CHANNEL;
+
+typedef enum enPS4000Range
+{
+  PS4000_10MV,
+  PS4000_20MV,
+  PS4000_50MV,
+  PS4000_100MV,
+  PS4000_200MV,
+  PS4000_500MV,
+  PS4000_1V,
+  PS4000_2V,
+  PS4000_5V,
+  PS4000_10V,
+  PS4000_20V,
+  PS4000_50V,
+  PS4000_100V,
+  PS4000_MAX_RANGES,
+
+  PS4000_RESISTANCE_100R = PS4000_MAX_RANGES,
+  PS4000_RESISTANCE_1K,
+  PS4000_RESISTANCE_10K,
+  PS4000_RESISTANCE_100K,
+  PS4000_RESISTANCE_1M,
+  PS4000_MAX_RESISTANCES,
+
+  PS4000_ACCELEROMETER_10MV = PS4000_MAX_RESISTANCES,
+  PS4000_ACCELEROMETER_20MV,
+  PS4000_ACCELEROMETER_50MV,
+  PS4000_ACCELEROMETER_100MV,
+  PS4000_ACCELEROMETER_200MV,
+  PS4000_ACCELEROMETER_500MV,
+  PS4000_ACCELEROMETER_1V,
+  PS4000_ACCELEROMETER_2V,
+  PS4000_ACCELEROMETER_5V,
+  PS4000_ACCELEROMETER_10V,
+  PS4000_ACCELEROMETER_20V,
+  PS4000_ACCELEROMETER_50V,
+  PS4000_ACCELEROMETER_100V,
+  PS4000_MAX_ACCELEROMETER,
+
+  PS4000_TEMPERATURE_UPTO_40 = PS4000_MAX_ACCELEROMETER,
+  PS4000_TEMPERATURE_UPTO_70,
+  PS4000_TEMPERATURE_UPTO_100,
+  PS4000_TEMPERATURE_UPTO_130,
+  PS4000_MAX_TEMPERATURES,
+
+  PS4000_RESISTANCE_5K = PS4000_MAX_TEMPERATURES,
+  PS4000_RESISTANCE_25K,
+  PS4000_RESISTANCE_50K,
+  PS4000_MAX_EXTRA_RESISTANCES
+} PS4000_RANGE;
+
+typedef enum enPS4000Probe
+{
+  P_NONE,
+  P_CURRENT_CLAMP_10A,
+  P_CURRENT_CLAMP_1000A,
+  P_TEMPERATURE_SENSOR,
+  P_CURRENT_MEASURING_DEVICE,
+  P_PRESSURE_SENSOR_50BAR,
+  P_PRESSURE_SENSOR_5BAR,
+  P_OPTICAL_SWITCH,
+  P_UNKNOWN,
+  P_MAX_PROBES = P_UNKNOWN
+} PS4000_PROBE;
+
+typedef enum enPS4000ChannelInfo
+{
+  CI_RANGES,
+  CI_RESISTANCES,
+  CI_ACCELEROMETER,
+  CI_PROBES,
+  CI_TEMPERATURES
+} PS4000_CHANNEL_INFO;
+
+typedef enum enPS4000EtsMode
+  {
+  PS4000_ETS_OFF,             // ETS disabled
+  PS4000_ETS_FAST,
+  PS4000_ETS_SLOW,
+  PS4000_ETS_MODES_MAX
+  }  PS4000_ETS_MODE;
+
+typedef enum enPS4000TimeUnits
+  {
+  PS4000_FS,
+  PS4000_PS,
+  PS4000_NS,
+  PS4000_US,
+  PS4000_MS,
+  PS4000_S,
+  PS4000_MAX_TIME_UNITS,
+  }  PS4000_TIME_UNITS;
+
+typedef enum enSweepType
+{
+  UP,
+  DOWN,
+  UPDOWN,
+  DOWNUP,
+  MAX_SWEEP_TYPES
+} SWEEP_TYPE;
+
+typedef enum enPS4000OperationTypes
+{
+  PS4000_OP_NONE,
+  PS4000_WHITENOISE,
+  PS4000_PRBS
+} PS4000_OPERATION_TYPES;
+
+typedef enum enWaveType
+{
+  PS4000_SINE,
+  PS4000_SQUARE,
+  PS4000_TRIANGLE,
+  PS4000_RAMP_UP,
+  PS4000_RAMP_DOWN,
+  PS4000_SINC,
+  PS4000_GAUSSIAN,
+  PS4000_HALF_SINE,
+  PS4000_DC_VOLTAGE,
+  PS4000_WHITE_NOISE,
+  MAX_WAVE_TYPES
+} WAVE_TYPE;
+
+typedef enum enSigGenTrigType
+{
+  SIGGEN_RISING,
+  SIGGEN_FALLING,
+  SIGGEN_GATE_HIGH,
+  SIGGEN_GATE_LOW
+} SIGGEN_TRIG_TYPE;
+
+typedef enum enSigGenTrigSource
+{
+  SIGGEN_NONE,
+  SIGGEN_SCOPE_TRIG,
+  SIGGEN_AUX_IN,
+  SIGGEN_EXT_IN,
+  SIGGEN_SOFT_TRIG
+} SIGGEN_TRIG_SOURCE;
+
+typedef enum enIndexMode
+{
+  SINGLE,
+  DUAL,
+  QUAD,
+  MAX_INDEX_MODES
+} INDEX_MODE;
+
+typedef enum enThresholdMode
+{
+  LEVEL,
+  WINDOW
+} THRESHOLD_MODE;
+
+typedef enum enThresholdDirection
+{
+  ABOVE, //using upper threshold
+  BELOW,
+  RISING, // using upper threshold
+  FALLING, // using upper threshold
+  RISING_OR_FALLING, // using both threshold
+  ABOVE_LOWER, // using lower threshold
+  BELOW_LOWER, // using lower threshold
+  RISING_LOWER,       // using lower threshold
+  FALLING_LOWER,     // using lower threshold
+
+  // Windowing using both thresholds
+  INSIDE = ABOVE,
+  OUTSIDE = BELOW,
+  ENTER = RISING,
+  EXIT = FALLING,
+  ENTER_OR_EXIT = RISING_OR_FALLING,
+  POSITIVE_RUNT = 9,
+  NEGATIVE_RUNT,
+
+  // no trigger set
+  NONE = RISING
+} THRESHOLD_DIRECTION;
+
+typedef enum enTriggerState
+{
+  CONDITION_DONT_CARE,
+  CONDITION_TRUE,
+  CONDITION_FALSE,
+  CONDITION_MAX
+} TRIGGER_STATE;
+
+#pragma pack(1)
+typedef struct tTriggerConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+  TRIGGER_STATE aux;
+  TRIGGER_STATE pulseWidthQualifier;
+} TRIGGER_CONDITIONS;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tPwqConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+  TRIGGER_STATE aux;
+} PWQ_CONDITIONS;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tTriggerChannelProperties
+{
+  int16_t thresholdUpper;
+  uint16_t thresholdUpperHysteresis;
+  int16_t thresholdLower;
+  uint16_t thresholdLowerHysteresis;
+  PS4000_CHANNEL channel;
+  THRESHOLD_MODE thresholdMode;
+} TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack()
+
+typedef enum enRatioMode
+{
+  RATIO_MODE_NONE,
+  RATIO_MODE_AGGREGATE = 1,
+  RATIO_MODE_AVERAGE = 2
+} RATIO_MODE;
+
+typedef enum enPulseWidthType
+{
+  PW_TYPE_NONE,
+  PW_TYPE_LESS_THAN,
+  PW_TYPE_GREATER_THAN,
+  PW_TYPE_IN_RANGE,
+  PW_TYPE_OUT_OF_RANGE
+} PULSE_WIDTH_TYPE;
+
+typedef enum enPs4000HoldOffType
+{
+  PS4000_TIME,
+  PS4000_MAX_HOLDOFF_TYPE
+} PS4000_HOLDOFF_TYPE;
+
+typedef enum enPS4000FrequencyCounterRange
+{
+  FC_2K,
+  FC_20K,
+  FC_20,
+  FC_200,
+  FC_MAX
+}PS4000_FREQUENCY_COUNTER_RANGE;
+
+typedef void (__stdcall *ps4000BlockReady)
+(
+  int16_t      handle,
+  PICO_STATUS  status,
+  void        *pParameter
+);
+
+typedef void (__stdcall *ps4000StreamingReady)
+(
+  int16_t   handle,
+  int32_t   noOfSamples,
+  uint32_t  startIndex,
+  int16_t   overflow,
+  uint32_t  triggerAt,
+  int16_t   triggered,
+  int16_t   autoStop,
+  void     *pParameter
+);
+
+typedef void (__stdcall *ps4000DataReady)
+(
+  int16_t   handle,
+  int32_t   noOfSamples,
+  int16_t   overflow,
+  uint32_t  triggerAt,
+  int16_t   triggered,
+  void     *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000OpenUnit)
+(
+  int16_t *handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000OpenUnitAsync)
+(
+  int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000OpenUnitEx)
+(
+  int16_t *handle,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000OpenUnitAsyncEx)
+(
+  int16_t *status,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000OpenUnitProgress)
+(
+  int16_t *handle,
+  int16_t *progressPercent,
+  int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetUnitInfo)
+(
+  int16_t    handle,
+  int8_t    *string,
+  int16_t    stringLength,
+  int16_t   *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000FlashLed)
+(
+  int16_t  handle,
+  int16_t  start
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000IsLedFlashing)
+(
+  int16_t  handle,
+  int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000CloseUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000MemorySegments)
+(
+  int16_t   handle,
+  uint16_t  nSegments,
+  int32_t  *nMaxSamples
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetChannel)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t         enabled,
+  int16_t         dc,
+  PS4000_RANGE    range
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetNoOfCaptures)
+(
+  int16_t   handle,
+  uint16_t  nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTimebase)
+(
+  int16_t   handle,
+  uint32_t  timebase,
+  int32_t   noSamples,
+  int32_t  *timeIntervalNanoseconds,
+  int16_t   oversample,
+  int32_t  *maxSamples,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTimebase2)
+(
+  int16_t   handle,
+  uint32_t  timebase,
+  int32_t   noSamples,
+  float    *timeIntervalNanoseconds,
+  int16_t   oversample,
+  int32_t  *maxSamples,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SigGenOff)
+(
+	int16_t handle
+);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetSigGenArbitrary)
+(
+  int16_t             handle,
+  int32_t             offsetVoltage,
+  uint32_t            pkToPk,
+  uint32_t            startDeltaPhase,
+  uint32_t            stopDeltaPhase,
+  uint32_t            deltaPhaseIncrement,
+  uint32_t            dwellCount,
+  int16_t            *arbitraryWaveform,
+  int32_t             arbitraryWaveformSize,
+  SWEEP_TYPE          sweepType,
+  int16_t             operationType,
+  INDEX_MODE          indexMode,
+  uint32_t            shots,
+  uint32_t            sweeps,
+  SIGGEN_TRIG_TYPE    triggerType,
+  SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t             extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000SetSigGenBuiltIn)
+(
+  int16_t             handle,
+  int32_t             offsetVoltage,
+  uint32_t            pkToPk,
+  int16_t             waveType,
+  float               startFrequency,
+  float               stopFrequency,
+  float               increment,
+  float               dwellTime,
+  SWEEP_TYPE          sweepType,
+  int16_t             operationType,
+  uint32_t            shots,
+  uint32_t            sweeps,
+  SIGGEN_TRIG_TYPE    triggerType,
+  SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t             extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000SigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	INDEX_MODE										indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000SigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SigGenSoftwareControl)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetEts)
+(
+  int16_t          handle,
+  PS4000_ETS_MODE  mode,
+  int16_t          etsCycles,
+  int16_t          etsInterleave,
+  int32_t         *sampleTimePicoseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetSimpleTrigger)
+(
+  int16_t handle,
+  int16_t enable,
+  PS4000_CHANNEL source,
+  int16_t threshold,
+  THRESHOLD_DIRECTION direction,
+  uint32_t delay,
+  int16_t autoTrigger_ms
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetTriggerChannelProperties)
+(
+  int16_t                     handle,
+  TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                     nChannelProperties,
+  int16_t                     auxOutputEnable,
+  int32_t                     autoTriggerMilliseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetExtTriggerRange)
+(
+  int16_t       handle,
+  PS4000_RANGE  extRange
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetTriggerChannelConditions)
+(
+  int16_t             handle,
+  TRIGGER_CONDITIONS *conditions,
+  int16_t             nConditions
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetTriggerChannelDirections)
+(
+  int16_t              handle,
+  THRESHOLD_DIRECTION  channelA,
+  THRESHOLD_DIRECTION  channelB,
+  THRESHOLD_DIRECTION  channelC,
+  THRESHOLD_DIRECTION  channelD,
+  THRESHOLD_DIRECTION  ext,
+  THRESHOLD_DIRECTION  aux
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetTriggerDelay)
+(
+  int16_t   handle,
+  uint32_t  delay
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetPulseWidthQualifier)
+(
+  int16_t              handle,
+  PWQ_CONDITIONS      *conditions,
+  int16_t              nConditions,
+  THRESHOLD_DIRECTION  direction,
+  uint32_t             lower,
+  uint32_t             upper,
+  PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000IsTriggerOrPulseWidthQualifierEnabled)
+(
+  int16_t  handle,
+  int16_t *triggerEnabled,
+  int16_t *pulseWidthQualifierEnabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTriggerTimeOffset)
+(
+  int16_t            handle,
+  uint32_t          *timeUpper,
+  uint32_t          *timeLower,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTriggerChannelTimeOffset)
+(
+  int16_t            handle,
+  uint32_t          *timeUpper,
+  uint32_t          *timeLower,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex,
+  PS4000_CHANNEL     channel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTriggerTimeOffset64)
+(
+  int16_t            handle,
+  int64_t           *time,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTriggerChannelTimeOffset64)
+(
+  int16_t            handle,
+  int64_t           *time,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex,
+  PS4000_CHANNEL     channel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesTriggerTimeOffsetBulk)
+(
+  int16_t            handle,
+  uint32_t          *timesUpper,
+  uint32_t          *timesLower,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesTriggerChannelTimeOffsetBulk)
+(
+  int16_t            handle,
+  uint32_t          *timesUpper,
+  uint32_t          *timesLower,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex,
+  PS4000_CHANNEL     channel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesTriggerTimeOffsetBulk64)
+(
+  int16_t            handle,
+  int64_t           *times,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesTriggerChannelTimeOffsetBulk64)
+(
+  int16_t            handle,
+  int64_t           *times,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex,
+  PS4000_CHANNEL     channel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetDataBufferBulk)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t        *buffer,
+  int32_t         bufferLth,
+  uint16_t        waveform
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetDataBuffers)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t        *bufferMax,
+  int16_t        *bufferMin,
+  int32_t         bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetDataBufferWithMode)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t        *buffer,
+  int32_t         bufferLth,
+  RATIO_MODE      mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetDataBuffersWithMode)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t        *bufferMax,
+  int16_t        *bufferMin,
+  int32_t         bufferLth,
+  RATIO_MODE      mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetDataBuffer)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t        *buffer,
+  int32_t         bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetEtsTimeBuffer)
+(
+  int16_t  handle,
+  int64_t *buffer,
+  int32_t  bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetEtsTimeBuffers)
+(
+  int16_t   handle,
+  uint32_t *timeUpper,
+  uint32_t *timeLower,
+  int32_t   bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000RunBlock)
+(
+  int16_t           handle,
+  int32_t           noOfPreTriggerSamples,
+  int32_t           noOfPostTriggerSamples,
+  uint32_t          timebase,
+  int16_t           oversample,
+  int32_t          *timeIndisposedMs,
+  uint16_t          segmentIndex,
+  ps4000BlockReady  lpReady,
+  void             *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000RunStreaming)
+(
+  int16_t            handle,
+  uint32_t          *sampleInterval,
+  PS4000_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t           maxPreTriggerSamples,
+  uint32_t           maxPostPreTriggerSamples,
+  int16_t            autoStop,
+  uint32_t           downSampleRatio,
+  uint32_t           overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000RunStreamingEx)
+(
+  int16_t            handle,
+  uint32_t          *sampleInterval,
+  PS4000_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t           maxPreTriggerSamples,
+  uint32_t           maxPostPreTriggerSamples,
+  int16_t            autoStop,
+  uint32_t           downSampleRatio,
+  int16_t            downSampleRatioMode,
+  uint32_t           overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000IsReady)
+(
+  int16_t handle,
+  int16_t * ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetStreamingLatestValues)
+(
+  int16_t               handle,
+  ps4000StreamingReady  lpPs4000Ready,
+  void                 *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000NoOfStreamingValues)
+(
+  int16_t   handle,
+  uint32_t *noOfValues
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetMaxDownSampleRatio)
+(
+  int16_t   handle,
+  uint32_t  noOfUnaggreatedSamples,
+  uint32_t *maxDownSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValues)
+(
+  int16_t   handle,
+  uint32_t  startIndex,
+  uint32_t *noOfSamples,
+  uint32_t  downSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex,
+  int16_t  *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesBulk)
+(
+  int16_t   handle,
+  uint32_t *noOfSamples,
+  uint16_t  fromSegmentIndex,
+  uint16_t  toSegmentIndex,
+  int16_t  *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesAsync)
+(
+  int16_t   handle,
+  uint32_t  startIndex,
+  uint32_t  noOfSamples,
+  uint32_t  downSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex,
+  void     *lpDataReady,
+  void     *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000Stop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetProbe)
+(
+  int16_t       handle,
+  PS4000_PROBE  probe,
+  PS4000_RANGE  range
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000HoldOff)
+(
+  int16_t              handle,
+  uint64_t             holdoff,
+  PS4000_HOLDOFF_TYPE  type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetProbe)
+(
+  int16_t       handle,
+  PS4000_PROBE *probe
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetChannelInformation)
+(
+  int16_t              handle,
+  PS4000_CHANNEL_INFO  info,
+  int32_t              probe,
+  int32_t             *ranges,
+  int32_t             *length,
+  int32_t              channels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetFrequencyCounter)
+(
+  int16_t                         handle,
+  PS4000_CHANNEL                  channel,
+  int16_t                         enabled,
+  PS4000_FREQUENCY_COUNTER_RANGE  range,
+  int16_t                         thresholdMajor,
+  int16_t                         thresholdMinor
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000EnumerateUnits)
+(
+  int16_t *count,
+  int8_t  *serials,
+  int16_t *serialLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000PingUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetBwFilter)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t         enable
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000TriggerWithinPreTriggerSamples)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetNoOfCaptures)
+(
+  int16_t   handle,
+  uint16_t *nCaptures
+);
+
+#endif

+ 1286 - 0
pico-tcp-service/pico-tcp-client/inc/ps4000aApi.h

@@ -0,0 +1,1286 @@
+/****************************************************************************
+ *
+ * Filename:    ps4000aApi.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *	PicoScope 4444 and 4824 PC Oscilloscopes.
+ *
+ * Copyright � 2013 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS4000AAPI_H__
+#define __PS4000AAPI_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+#include "PicoCallback.h"
+#include "PicoConnectProbes.h"
+#include "PicoVersion.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+	#define PREF0 extern "C"
+#else
+	#define PREF0
+#endif
+
+#ifdef WIN32
+/*	If you are dynamically linking ps4000a.dll into your project #define DYNLINK here
+ */
+#ifdef DYNLINK
+  #define PREF1 typedef
+	#define PREF2
+	#define PREF3(x) (__stdcall *x)
+#else
+  #define PREF1
+	#ifdef _USRDLL
+		#define PREF2 __declspec(dllexport) __stdcall
+	#else
+		#define PREF2 __declspec(dllimport) __stdcall
+	#endif
+  #define PREF3(x) x
+#endif
+	#define PREF4 __stdcall
+#else
+
+	/* Define a 64-bit integer type */
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+	#define PREF4
+#endif
+
+#define PS4000A_EXT_MAX_VALUE  32767
+#define PS4000A_EXT_MIN_VALUE -32767
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+#define MAX_DELAY_COUNT 8388607L
+
+#define PS4000A_MAX_SIG_GEN_BUFFER_SIZE 16384
+
+#define PS4000A_MIN_SIG_GEN_BUFFER_SIZE 10
+#define PS4000A_MIN_DWELL_COUNT				10
+#define PS4000A_MAX_SWEEPS_SHOTS				((1 << 30) - 1)
+#define	PS4000A_AWG_DAC_FREQUENCY							80e6
+#define	PS4000A_AWG_PHASE_ACCUMULATOR  4294967296.0
+
+#define PS4000A_MAX_ANALOGUE_OFFSET_50MV_200MV	 0.250f
+#define PS4000A_MIN_ANALOGUE_OFFSET_50MV_200MV	-0.250f
+#define PS4000A_MAX_ANALOGUE_OFFSET_500MV_2V		 2.500f
+#define PS4000A_MIN_ANALOGUE_OFFSET_500MV_2V		-2.500f
+#define PS4000A_MAX_ANALOGUE_OFFSET_5V_20V			 20.f
+#define PS4000A_MIN_ANALOGUE_OFFSET_5V_20V			-20.f
+#define PS4000A_MAX_ANALOGUE_OFFSET_10V_50V      25.f
+#define PS4000A_MIN_ANALOGUE_OFFSET_10V_50V     -25.f
+
+
+typedef enum enPS4000ADeviceResolution
+{
+	PS4000A_DR_8BIT,
+	PS4000A_DR_12BIT,
+	PS4000A_DR_14BIT,
+	PS4000A_DR_15BIT,
+	PS4000A_DR_16BIT,
+} PS4000A_DEVICE_RESOLUTION;
+
+typedef enum enPS4000AExtraOperations
+{
+	PS4000A_ES_OFF,
+	PS4000A_WHITENOISE,
+	PS4000A_PRBS // Pseudo-Random Bit Stream
+} PS4000A_EXTRA_OPERATIONS;
+
+typedef enum	enPS4000ABandwidthLimiterFlags
+{
+	PS4000A_BW_FULL_FLAG = (1 << 0),
+	PS4000A_BW_20KHZ_FLAG = (1 << 1),
+	PS4000A_BW_100KHZ_FLAG = (1 << 2), //( default when current clamp detected: can be changed)
+	PS4000A_BW_1MHZ_FLAG  = (1 << 3)  //( default for 14 bits: can be changed)
+} PS4000A_BANDWIDTH_LIMITER_FLAGS;
+
+typedef enum	enPS4000ABandwidthLimiter
+{
+	PS4000A_BW_FULL,
+	PS4000A_BW_20KHZ,
+	PS4000A_BW_100KHZ, //( default when current clamp detected: can be changed)
+	PS4000A_BW_1MHZ
+} PS4000A_BANDWIDTH_LIMITER;
+
+typedef enum enPS4000ACoupling
+{
+	PS4000A_AC,
+	PS4000A_DC
+} PS4000A_COUPLING;
+
+typedef enum enPS4000AChannel
+{
+	PS4000A_CHANNEL_A,
+	PS4000A_CHANNEL_B,
+	PS4000A_CHANNEL_C,
+	PS4000A_CHANNEL_D,
+	PS4000A_MAX_4_CHANNELS,
+	PS4000A_CHANNEL_E = PS4000A_MAX_4_CHANNELS,
+	PS4000A_CHANNEL_F,
+	PS4000A_CHANNEL_G,
+	PS4000A_CHANNEL_H,
+	PS4000A_EXTERNAL,
+	PS4000A_MAX_CHANNELS = PS4000A_EXTERNAL,
+	PS4000A_TRIGGER_AUX,
+	PS4000A_MAX_TRIGGER_SOURCES,
+	PS4000A_PULSE_WIDTH_SOURCE = 0x10000000
+}	PS4000A_CHANNEL;
+
+
+
+typedef enum enPS4000AChannelBufferIndex
+{
+	PS4000A_CHANNEL_A_MAX,
+	PS4000A_CHANNEL_A_MIN,
+	PS4000A_CHANNEL_B_MAX,
+	PS4000A_CHANNEL_B_MIN,
+	PS4000A_CHANNEL_C_MAX,
+	PS4000A_CHANNEL_C_MIN,
+	PS4000A_CHANNEL_D_MAX,
+	PS4000A_CHANNEL_D_MIN,
+	PS4000A_CHANNEL_E_MAX,
+	PS4000A_CHANNEL_E_MIN,
+	PS4000A_CHANNEL_F_MAX,
+	PS4000A_CHANNEL_F_MIN,
+	PS4000A_CHANNEL_G_MAX,
+	PS4000A_CHANNEL_G_MIN,
+	PS4000A_CHANNEL_H_MAX,
+	PS4000A_CHANNEL_H_MIN,
+	PS4000A_MAX_CHANNEL_BUFFERS
+} PS4000A_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS4000ARange
+{
+	PS4000A_10MV,
+	PS4000A_20MV,
+	PS4000A_50MV,
+	PS4000A_100MV,
+	PS4000A_200MV,
+	PS4000A_500MV,
+	PS4000A_1V,
+	PS4000A_2V,
+	PS4000A_5V,
+	PS4000A_10V,
+	PS4000A_20V,
+	PS4000A_50V,
+	PS4000A_100V,
+	PS4000A_200V,
+	PS4000A_MAX_RANGES
+}	PS4000A_RANGE;
+
+typedef enum enPS4000AResistanceRange
+{
+	PS4000A_RESISTANCE_315K = 0x00000200,
+	PS4000A_RESISTANCE_1100K,
+	PS4000A_RESISTANCE_10M,
+	PS4000A_MAX_RESISTANCE_RANGES = (PS4000A_RESISTANCE_10M + 1) - PS4000A_RESISTANCE_315K,
+	PS4000A_RESISTANCE_ADCV = 0x10000000
+}	PS4000A_RESISTANCE_RANGE;
+
+typedef enum enPS4000AEtsMode
+  {
+  PS4000A_ETS_OFF,             // ETS disabled
+  PS4000A_ETS_FAST,            // Return ready as soon as requested no of interleaves is available
+  PS4000A_ETS_SLOW,            // Return ready every time a new set of no_of_cycles is collected
+  PS4000A_ETS_MODES_MAX
+  }	PS4000A_ETS_MODE;
+
+typedef enum enPS4000ATimeUnits
+  {
+  PS4000A_FS,
+  PS4000A_PS,
+  PS4000A_NS,
+  PS4000A_US,
+  PS4000A_MS,
+  PS4000A_S,
+  PS4000A_MAX_TIME_UNITS,
+  }	PS4000A_TIME_UNITS;
+
+typedef enum enPS4000ASweepType
+{
+	PS4000A_UP,
+	PS4000A_DOWN,
+	PS4000A_UPDOWN,
+	PS4000A_DOWNUP,
+	PS4000A_MAX_SWEEP_TYPES
+} PS4000A_SWEEP_TYPE;
+
+typedef enum enPS4000AWaveType
+{
+	PS4000A_SINE,
+	PS4000A_SQUARE,
+	PS4000A_TRIANGLE,
+	PS4000A_RAMP_UP,
+	PS4000A_RAMP_DOWN,
+	PS4000A_SINC,
+	PS4000A_GAUSSIAN,
+	PS4000A_HALF_SINE,
+	PS4000A_DC_VOLTAGE,
+	PS4000A_WHITE_NOISE,
+	PS4000A_MAX_WAVE_TYPES
+} PS4000A_WAVE_TYPE;
+
+typedef enum enPS4000APinStates
+{
+	PS4000A_CAL_PINS_OFF,
+	PS4000A_GND_SIGNAL,
+	PS4000A_SIGNAL_SIGNAL
+} PS4000A_PIN_STATES;
+
+#define PS4000A_SINE_MAX_FREQUENCY				1000000.f
+#define PS4000A_SQUARE_MAX_FREQUENCY			1000000.f
+#define PS4000A_TRIANGLE_MAX_FREQUENCY		1000000.f
+#define PS4000A_SINC_MAX_FREQUENCY				1000000.f
+#define PS4000A_RAMP_MAX_FREQUENCY				1000000.f
+#define PS4000A_HALF_SINE_MAX_FREQUENCY	1000000.f
+#define PS4000A_GAUSSIAN_MAX_FREQUENCY		1000000.f
+#define PS4000A_MIN_FREQUENCY									 0.03f
+
+typedef enum enPS4000AChannelLed
+{
+	PS4000A_CHANNEL_LED_OFF,
+	PS4000A_CHANNEL_LED_RED,
+	PS4000A_CHANNEL_LED_GREEN
+} PS4000A_CHANNEL_LED;
+
+typedef enum enPS4000AProbeLedPosition
+{
+	PS4000A_UPPER_LEFT_LED = 1,
+	PS4000A_LOWER_LEFT_LED = 2,
+	PS4000A_UPPER_RIGHT_LED = 4,
+	PS4000A_LOWER_RIGHT_LED = 8,
+
+	PS4000A_RIGHT_LEDS = PS4000A_UPPER_RIGHT_LED | PS4000A_LOWER_RIGHT_LED,
+	PS4000A_LEFT_LEDS = PS4000A_UPPER_LEFT_LED | PS4000A_LOWER_LEFT_LED,
+
+	PS4000A_UPPER_LEDS = PS4000A_UPPER_RIGHT_LED | PS4000A_UPPER_LEFT_LED,
+	PS4000A_LOWER_LEDS = PS4000A_LOWER_RIGHT_LED | PS4000A_LOWER_LEFT_LED,
+
+	PS4000A_ALL_LEDS = PS4000A_UPPER_LEFT_LED | PS4000A_LOWER_LEFT_LED | PS4000A_UPPER_RIGHT_LED | PS4000A_LOWER_RIGHT_LED
+} PS4000A_PROBE_LED_POSITION;
+
+typedef enum enPS4000AMetaType
+{
+	PS4000A_MT_UNIT_INFO,
+	PS4000A_MT_DEVICE_CAPABILITY,
+	PS4000A_MT_DEVICE_SETTINGS,
+	PS4000A_MT_SIGNAL_GENERATOR_SETTINGS
+} PS4000A_META_TYPE;
+
+typedef enum enPS4000AMetaOperation
+{
+	PS4000A_MO_READ,
+	PS4000A_MO_WRITE
+} PS4000A_META_OPERATION;
+
+typedef enum enPS4000AMetaFormat
+{
+	PS4000A_MF_COMMA_SEPARATED,
+	PS4000A_MF_XML
+} PS4000A_META_FORMAT;
+
+typedef enum enPS4000ASigGenTrigType
+{
+	PS4000A_SIGGEN_RISING,
+	PS4000A_SIGGEN_FALLING,
+	PS4000A_SIGGEN_GATE_HIGH,
+	PS4000A_SIGGEN_GATE_LOW
+} PS4000A_SIGGEN_TRIG_TYPE;
+
+typedef enum enPS4000ASigGenTrigSource
+{
+	PS4000A_SIGGEN_NONE,
+	PS4000A_SIGGEN_SCOPE_TRIG,
+	PS4000A_SIGGEN_AUX_IN,
+	PS4000A_SIGGEN_EXT_IN,
+	PS4000A_SIGGEN_SOFT_TRIG
+} PS4000A_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPS4000AIndexMode
+{
+	PS4000A_SINGLE,
+	PS4000A_DUAL,
+	PS4000A_QUAD,
+	PS4000A_MAX_INDEX_MODES
+} PS4000A_INDEX_MODE;
+
+typedef enum enPS4000AThresholdMode
+{
+	PS4000A_LEVEL,
+	PS4000A_WINDOW
+} PS4000A_THRESHOLD_MODE;
+
+typedef enum enPS4000AThresholdDirection
+{
+	PS4000A_ABOVE, //using upper threshold
+	PS4000A_BELOW, //using upper threshold
+	PS4000A_RISING, // using upper threshold
+	PS4000A_FALLING, // using upper threshold
+	PS4000A_RISING_OR_FALLING, // using both threshold
+	PS4000A_ABOVE_LOWER, // using lower threshold
+	PS4000A_BELOW_LOWER, // using lower threshold
+	PS4000A_RISING_LOWER,			 // using lower threshold
+	PS4000A_FALLING_LOWER,		 // using lower threshold
+
+	// Windowing using both thresholds
+	PS4000A_INSIDE = PS4000A_ABOVE,
+	PS4000A_OUTSIDE = PS4000A_BELOW,
+	PS4000A_ENTER = PS4000A_RISING,
+	PS4000A_EXIT = PS4000A_FALLING,
+	PS4000A_ENTER_OR_EXIT = PS4000A_RISING_OR_FALLING,
+	PS4000A_POSITIVE_RUNT = 9,
+  PS4000A_NEGATIVE_RUNT,
+
+	// no trigger set
+  PS4000A_NONE = PS4000A_RISING
+} PS4000A_THRESHOLD_DIRECTION;
+
+
+typedef enum enPS4000ATriggerState
+{
+  PS4000A_CONDITION_DONT_CARE,
+  PS4000A_CONDITION_TRUE,
+  PS4000A_CONDITION_FALSE,
+	PS4000A_CONDITION_MAX
+} PS4000A_TRIGGER_STATE;
+
+typedef enum enPS4000ASensorState
+{
+	PS4000A_CONNECT_STATE_FLOATING,
+	PS4000A_SENSOR_STATE_CONNECTED
+} PS4000A_SENSOR_STATE;
+
+typedef enum enPS4000AFrequencyCounterRange
+{
+  PS4000A_FC_2K,
+  PS4000A_FC_20K,
+  PS4000A_FC_20,
+  PS4000A_FC_200,
+  PS4000A_FC_MAX
+}PS4000A_FREQUENCY_COUNTER_RANGE;
+
+typedef enum enPS4000AChannelFlags
+{
+	PS4000A_CHANNEL_A_FLAGS = 1,
+	PS4000A_CHANNEL_B_FLAGS = 2,
+	PS4000A_CHANNEL_C_FLAGS = 4,
+	PS4000A_CHANNEL_D_FLAGS = 8,
+	PS4000A_CHANNEL_E_FLAGS = 16,
+	PS4000A_CHANNEL_F_FLAGS = 32,
+	PS4000A_CHANNEL_G_FLAGS = 64,
+	PS4000A_CHANNEL_H_FLAGS = 128,
+}	PS4000A_CHANNEL_FLAGS;
+
+#pragma pack(push,1)
+typedef struct tPS4000AChannelLedSetting
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_CHANNEL_LED state;
+} PS4000A_CHANNEL_LED_SETTING;
+
+typedef struct ps4000aProbeLedColour
+{
+	uint8_t red;
+	uint8_t green;
+	uint8_t blue;
+} PS4000A_PROBE_LED_COLOUR;
+
+typedef struct tPS4000AProbeChannelLedSetting
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_PROBE_LED_POSITION position;
+	PS4000A_PROBE_LED_COLOUR rgb;
+} PS4000A_PROBE_CHANNEL_LED_SETTING;
+
+typedef struct tPS4000ADirection
+{
+	PS4000A_CHANNEL							channel;
+	PS4000A_THRESHOLD_DIRECTION direction;
+} PS4000A_DIRECTION;
+
+
+typedef struct tPS4000ACondition
+{
+	PS4000A_CHANNEL   		source;
+  PS4000A_TRIGGER_STATE condition;
+} PS4000A_CONDITION;
+
+typedef enum enPS4000AConditionsInfo
+{
+	PS4000A_CLEAR = 0x00000001,
+  PS4000A_ADD = 0x00000002
+} PS4000A_CONDITIONS_INFO;
+
+typedef struct tPS4000ATriggerChannelProperties
+{
+  int16_t										thresholdUpper;
+	uint16_t					thresholdUpperHysteresis;
+  int16_t										thresholdLower;
+	uint16_t					thresholdLowerHysteresis;
+	PS4000A_CHANNEL					channel;
+  PS4000A_THRESHOLD_MODE	thresholdMode;
+} PS4000A_TRIGGER_CHANNEL_PROPERTIES;
+
+typedef struct tPS4000AConnectDetect
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_SENSOR_STATE state;
+} PS4000A_CONNECT_DETECT;
+
+typedef struct tPS4000AUserProbeInteractions
+{
+	uint16_t connected;
+
+	PS4000A_CHANNEL channel;
+	uint16_t enabled;
+
+	PicoConnectProbe probeName;
+
+	uint8_t requiresPower_;
+	uint8_t isPowered_;
+
+	PICO_STATUS status_;
+
+	PICO_CONNECT_PROBE_RANGE probeOff;
+
+	PICO_CONNECT_PROBE_RANGE rangeFirst_;
+	PICO_CONNECT_PROBE_RANGE rangeLast_;
+	PICO_CONNECT_PROBE_RANGE rangeCurrent_;
+
+	PS4000A_COUPLING couplingFirst_;
+	PS4000A_COUPLING couplingLast_;
+	PS4000A_COUPLING couplingCurrent_;
+
+	PS4000A_BANDWIDTH_LIMITER_FLAGS filterFlags_;
+	PS4000A_BANDWIDTH_LIMITER_FLAGS filterCurrent_;
+
+	PS4000A_BANDWIDTH_LIMITER defaultFilter_;
+} PS4000A_USER_PROBE_INTERACTIONS;
+#pragma pack(pop)
+
+
+typedef enum enPS4000ARatioMode
+{
+	PS4000A_RATIO_MODE_NONE = 0,
+	PS4000A_RATIO_MODE_AGGREGATE = 1,
+	PS4000A_RATIO_MODE_DECIMATE = 2,
+	PS4000A_RATIO_MODE_AVERAGE = 4,
+	PS4000A_RATIO_MODE_DISTRIBUTION = 8
+} PS4000A_RATIO_MODE;
+
+typedef enum enPS4000APulseWidthType
+{
+	PS4000A_PW_TYPE_NONE,
+  PS4000A_PW_TYPE_LESS_THAN,
+	PS4000A_PW_TYPE_GREATER_THAN,
+	PS4000A_PW_TYPE_IN_RANGE,
+	PS4000A_PW_TYPE_OUT_OF_RANGE
+} PS4000A_PULSE_WIDTH_TYPE;
+
+typedef enum enPS4000AChannelInfo
+{
+	PS4000A_CI_RANGES,
+	PS4000A_CI_RESISTANCES,
+} PS4000A_CHANNEL_INFO;
+
+typedef void (PREF4 *ps4000aBlockReady)
+	(
+		int16_t											handle,
+		PICO_STATUS								status,
+		void										*	pParameter
+	);
+
+typedef void (PREF4 *ps4000aStreamingReady)
+	(
+		int16_t    									handle,
+		int32_t     									noOfSamples,
+		uint32_t							startIndex,
+		int16_t    									overflow,
+		uint32_t							triggerAt,
+		int16_t    									triggered,
+		int16_t    									autoStop,
+		void										*	pParameter
+	);
+
+
+typedef void (PREF4 *ps4000aDataReady)
+	(
+		int16_t    									handle,
+		PICO_STATUS								status,
+		uint32_t     				noOfSamples,
+		int16_t    									overflow,
+		void										*	pParameter
+	);
+
+
+typedef void (PREF4 *ps4000aProbeInteractions)
+	(
+		int16_t    												handle,
+		PICO_STATUS												status,
+		PS4000A_USER_PROBE_INTERACTIONS * probes,
+		uint32_t													nProbes
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aOpenUnitWithResolution)
+(
+	int16_t											* handle,
+	int8_t											* serial,
+	PS4000A_DEVICE_RESOLUTION			resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnit)
+  (
+	  int16_t											* handle,
+		int8_t											* serial
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aOpenUnitAsyncWithResolution)
+(
+	int16_t											* status,
+	int8_t											* serial,
+	PS4000A_DEVICE_RESOLUTION			resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnitAsync)
+  (
+	  int16_t											* status,
+		int8_t											* serial
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnitProgress)
+	(
+	  int16_t 										* handle,
+	  int16_t 										* progressPercent,
+	  int16_t 										* complete
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetUnitInfo)
+ 	(
+	  int16_t     								  handle,
+	  int8_t      								* string,
+	  int16_t     								  stringLength,
+	  int16_t     								* requiredSize,
+	  PICO_INFO 								  info
+	);
+
+// This function retrieves information about the accessory (e.g. probe) attached to the specified channel.
+// Note: you must set a probe interaction callback to be able to retrieve probe information.
+//
+// parameters:
+// handle: identifies the device to which the accessory is attached.
+// channel: identifies the channel to which the accessory is attached. If no accessory is connected to this channel, an error will result.
+// string: on exit, the accessory information string selected specified by the info argument. If string is NULL, only requiredSize is returned.
+// stringLength: the maximum number of 8-bit integers (int8_t) that may be written to string.
+// requiredSize: on exit, the required length of the string array.
+// info: a number specifying what information is required. Note that unlike ps6000aGetUnitInfo, only PICO_BATCH_AND_SERIAL and PICO_CAL_DATE are valid for accessories.
+//
+// return:
+// PICO_OK
+// PICO_INVALID_HANDLE (handle isn't that of an open PicoScope device.)
+// PICO_PROBE_COLLECTION_NOT_STARTED (handle hasn't got a probe interaction callback set).
+// PICO_INVALID_CHANNEL (channel doesn't map to a channel on the device with handle.)
+// PICO_NULL_PARAMETER (requiredSize is NULL.)
+// PICO_INVALID_INFO (info is an invalid value for the attached accessory.)
+// PICO_INFO_UNAVAILABLE (no accessory is connected, or the connected accessory does not support any info.)
+// PICO_DRIVER_FUNCTION (another thread is already calling a driver function.)
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetAccessoryInfo)
+  (
+	  int16_t     								  handle,
+	  PS4000A_CHANNEL							  channel,
+	  int8_t											* string,
+	  int16_t     								  stringLength,
+	  int16_t											* requiredSize,
+	  PICO_INFO 								  info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aFlashLed)
+	(
+	  int16_t 											handle,
+		int16_t 											start
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetChannelLed)
+	(
+	int16_t 												handle,
+	PS4000A_CHANNEL_LED_SETTING		*	ledStates,
+	uint16_t												nLedStates
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsLedFlashing)
+	(
+	  int16_t 										  handle,
+		int16_t 										* status
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aCloseUnit)
+	(
+	  int16_t												handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMemorySegments)
+	(
+	  int16_t												handle,
+		uint32_t								nSegments,
+		int32_t											* nMaxSamples
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetChannel)
+ 	(
+	  int16_t											handle,
+		PS4000A_CHANNEL						channel,
+	  int16_t											enabled,
+	  PS4000A_COUPLING					type,
+		PICO_CONNECT_PROBE_RANGE				range,
+		float											analogOffset
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetBandwidthFilter)
+ 	(
+	  int16_t												handle,
+	  PS4000A_CHANNEL							channel,
+	  PS4000A_BANDWIDTH_LIMITER		bandwidth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aApplyResistanceScaling)
+	(
+	int16_t											handle,
+	PS4000A_CHANNEL							channel,
+	PICO_CONNECT_PROBE_RANGE					range,
+	int16_t										* bufferMax,
+	int16_t										* bufferMin,
+	uint32_t										buffertLth,
+	int16_t										* overflow
+	);
+
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTimebase)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   int32_t											* timeIntervalNanoseconds,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTimebase2)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   float										* timeIntervalNanoseconds,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSigGenArbitrary)
+	(
+	 	int16_t												handle,
+	 	int32_t												offsetVoltage,
+	 	uint32_t								pkToPk,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+	 	int16_t											*	arbitraryWaveform,
+	 	int32_t												arbitraryWaveformSize,
+		PS4000A_SWEEP_TYPE					sweepType,
+		PS4000A_EXTRA_OPERATIONS		operation,
+		PS4000A_INDEX_MODE					indexMode,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetSigGenBuiltIn)
+	(
+		int16_t												handle,
+		int32_t												offsetVoltage,
+		uint32_t								pkToPk,
+		PS4000A_WAVE_TYPE						waveType,
+		double											startFrequency,
+		double											stopFrequency,
+		double											increment,
+		double											dwellTime,
+		PS4000A_SWEEP_TYPE					sweepType,
+		PS4000A_EXTRA_OPERATIONS		operation,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+		);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSigGenPropertiesArbitrary)
+	(
+	 	int16_t												handle,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+		PS4000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetSigGenPropertiesBuiltIn)
+	(
+		int16_t												handle,
+		double											startFrequency,
+		double											stopFrequency,
+		double											increment,
+		double											dwellTime,
+		PS4000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSigGenFrequencyToPhase)
+	(
+		int16_t												handle,
+		double												frequency,
+		PS4000A_INDEX_MODE						indexMode,
+		uint32_t											bufferLength,
+		uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSigGenSoftwareControl)
+	(
+		int16_t												handle,
+		int16_t												state
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEts)
+  (
+		int16_t												handle,
+		PS4000A_ETS_MODE						mode,
+		int16_t												etsCycles,
+		int16_t												etsInterleave,
+		int32_t											* sampleTimePicoseconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelProperties)
+	(
+		int16_t																				handle,
+		PS4000A_TRIGGER_CHANNEL_PROPERTIES			 *	channelProperties,
+		int16_t																				nChannelProperties,
+		int16_t																				auxOutputEnable,
+		int32_t																				autoTriggerMilliseconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelConditions)
+	(
+		int16_t													handle,
+		PS4000A_CONDITION					*		conditions,
+		int16_t													nConditions,
+		PS4000A_CONDITIONS_INFO				info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelDirections)
+	(
+		int16_t													handle,
+		PS4000A_DIRECTION					*		directions,
+		int16_t													nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSimpleTrigger)
+	(
+		int16_t												handle,
+		int16_t												enable,
+		PS4000A_CHANNEL							source,
+		int16_t												threshold,
+		PS4000A_THRESHOLD_DIRECTION direction,
+		uint32_t								delay,
+		int16_t												autoTrigger_ms
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerDelay)
+	(
+		int16_t									handle,
+		uint32_t					delay
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetPulseWidthQualifierProperties)
+	(
+		int16_t														handle,
+		PS4000A_THRESHOLD_DIRECTION			direction,
+		uint32_t										lower,
+		uint32_t										upper,
+		PS4000A_PULSE_WIDTH_TYPE				type
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetPulseWidthQualifierConditions)
+	(
+		int16_t												handle,
+		PS4000A_CONDITION					*	conditions,
+		int16_t												nConditions,
+		PS4000A_CONDITIONS_INFO			info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsTriggerOrPulseWidthQualifierEnabled)
+	(
+		int16_t 								handle,
+		int16_t 							* triggerEnabled,
+		int16_t 							* pulseWidthQualifierEnabled
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTriggerTimeOffset)
+	(
+		int16_t									handle,
+		uint32_t 			* timeUpper,
+		uint32_t 			* timeLower,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					segmentIndex
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTriggerTimeOffset64)
+	(
+		int16_t									handle,
+		int64_t							* time,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t				segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesTriggerTimeOffsetBulk)
+	(
+	  int16_t									handle,
+		uint32_t				*	timesUpper,
+		uint32_t				* timesLower,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					fromSegmentIndex,
+		uint32_t					toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesTriggerTimeOffsetBulk64)
+	(
+	  int16_t									handle,
+		int64_t							*	times,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					fromSegmentIndex,
+		uint32_t					toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetDataBuffers)
+(
+   int16_t									handle,
+	 PS4000A_CHANNEL 				channel,
+	 int16_t								*	bufferMax,
+	 int16_t								*	bufferMin,
+   int32_t										bufferLth,
+	 uint32_t					segmentIndex,
+	 PS4000A_RATIO_MODE			mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetDataBuffer)
+(
+   int16_t								 handle,
+	 PS4000A_CHANNEL 			 channel,
+	 int16_t							*  buffer,
+   int32_t									 bufferLth,
+	 uint32_t				 segmentIndex,
+	 PS4000A_RATIO_MODE		 mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEtsTimeBuffer)
+(
+   int16_t									handle,
+	 int64_t *							buffer,
+	 int32_t										bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEtsTimeBuffers)
+(
+   int16_t									handle,
+	 uint32_t				* timeUpper,
+	 uint32_t				* timeLower,
+	 int32_t										bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsReady)
+	(
+		int16_t handle,
+		int16_t * ready
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aRunBlock)
+	(
+		int16_t									handle,
+		int32_t									noOfPreTriggerSamples,
+		int32_t									noOfPostTriggerSamples,
+		uint32_t					timebase,
+		int32_t								* timeIndisposedMs,
+		uint32_t					segmentIndex,
+		ps4000aBlockReady			lpReady,
+		void								* pParameter
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aRunStreaming)
+  (
+	  int16_t									handle,
+		uint32_t				* sampleInterval,
+		PS4000A_TIME_UNITS		sampleIntervalTimeUnits,
+	  uint32_t					maxPreTriggerSamples,
+	  uint32_t					maxPostTriggerSamples,
+		int16_t									autoStop,
+		uint32_t					downSampleRatio,
+		PS4000A_RATIO_MODE		downSampleRatioMode,
+    uint32_t					overviewBufferSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetStreamingLatestValues)
+  (
+    int16_t									handle,
+    ps4000aStreamingReady	lpPs4000aReady,
+		void								* pParameter
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aNoOfStreamingValues)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfValues
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetMaxDownSampleRatio)
+	(
+	  int16_t								handle,
+		uint32_t 			noOfUnaggregatedSamples,
+		uint32_t 		* maxDownSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValues)
+	(
+	  int16_t								handle,
+		uint32_t 			startIndex,
+	  uint32_t			*	noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex,
+		int16_t							* overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesAsync)
+	(
+	  int16_t								handle,
+		uint32_t				startIndex,
+	  uint32_t				noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex,
+	  void							*	lpDataReady,
+		void							*	pParameter
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesBulk)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfSamples,
+		uint32_t				fromSegmentIndex,
+		uint32_t				toSegmentIndex,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE 	downSampleRatioMode,
+		int16_t							* overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesOverlapped)
+	(
+	  int16_t										handle,
+	  uint32_t			 			startIndex,
+	  uint32_t					*	noOfSamples,
+	  uint32_t						downSampleRatio,
+	  PS4000A_RATIO_MODE			downSampleRatioMode,
+		uint32_t						segmentIndex,
+	  int16_t									* overflow
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesOverlappedBulk)
+	(
+	  int16_t									handle,
+		uint32_t					startIndex,
+  	uint32_t 	 		*	noOfSamples,
+	  uint32_t					downSampleRatio,
+	  PS4000A_RATIO_MODE		downSampleRatioMode,
+	  uint32_t					fromSegmentIndex,
+	  uint32_t					toSegmentIndex,
+	  int16_t								*	overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aEnumerateUnits)
+	(
+	int16_t * count,
+	int8_t * serials,
+	int16_t * serialLth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetChannelInformation)
+	(
+	int16_t										handle,
+	PS4000A_CHANNEL_INFO		info,
+	int32_t											probe,
+	int32_t										* ranges,
+	int32_t										* length,
+	int32_t											channels);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aConnectDetect)
+	(
+	int16_t		handle,
+	PS4000A_CONNECT_DETECT * sensor,
+	int16_t  nSensors
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeInteractionCallback)
+ (
+	int16_t		handle,
+	ps4000aProbeInteractions callback
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aCalibrateProbe)
+(
+	int16_t	handle,
+	PS4000A_CHANNEL channel,
+	int16_t * checkCalibrationRequired
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeLedColour)
+(
+	int16_t		handle,
+	PS4000A_PROBE_CHANNEL_LED_SETTING * settings,
+	uint16_t nSettings
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aRegisterProbeLedColour)
+(
+	int16_t		handle,
+	PICO_CONNECT_PROBE probe,
+	PS4000A_PROBE_CHANNEL_LED_SETTING * settings,
+	uint16_t nSettings
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeLedDefaults)
+  (
+    int16_t handle,
+    int16_t enabled
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMaximumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMinimumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetAnalogueOffset)
+	(
+	int16_t							handle,
+	PICO_CONNECT_PROBE_RANGE	range,
+	PS4000A_COUPLING		coupling,
+	float							* maximumOffset,
+	float							* minimumOffset
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetMaxSegments)
+	(
+	int16_t						handle,
+	uint32_t * maxSegments
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aChangePowerSource)
+	(
+	int16_t				handle,
+  PICO_STATUS powerState
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aCurrentPowerSource)
+	(
+	int16_t		handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aStop)
+	(
+	  int16_t handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aPingUnit)
+	(
+	  int16_t handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetNoOfCaptures)
+	(
+	int16_t					handle,
+	uint32_t nCaptures
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetNoOfCaptures)
+  (
+    int16_t                handle,
+    uint32_t               * nCaptures
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetNoOfProcessedCaptures)
+  (
+    int16_t                handle,
+    uint32_t               * nProcessedCaptures
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aDeviceMetaData)
+	(
+	int16_t										handle,
+	int8_t									*	settings,
+	int32_t									*	nSettingsLength,
+	PS4000A_META_TYPE					type,
+	PS4000A_META_OPERATION		operation,
+	PS4000A_META_FORMAT				format
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetString)
+	(
+	int16_t										handle,
+	PICO_STRING_VALUE					stringValue,
+	int8_t									*	string,
+	int32_t									*	stringLength
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetCommonModeOverflow)
+	(
+	int16_t			handle,
+	uint16_t	*	overflow
+	);
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetFrequencyCounter)
+(
+    int16_t                                handle,
+    PS4000A_CHANNEL                        channel,
+    int16_t                                enabled,
+    PS4000A_FREQUENCY_COUNTER_RANGE        range,
+    int16_t                                thresholdMajor,
+    int16_t                                thresholdMinor
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetDeviceResolution)
+(
+  int16_t                          handle,
+  PS4000A_DEVICE_RESOLUTION        resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetDeviceResolution)
+(
+	int16_t                      handle,
+	PS4000A_DEVICE_RESOLUTION    * resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetCalibrationPins)
+(
+	int16_t               handle,
+	PS4000A_PIN_STATES		pinStates,
+	PS4000A_WAVE_TYPE			waveType,
+	double								frequency,
+	uint32_t							amplitude,
+	uint32_t							offset
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aNearestSampleIntervalStateless)
+(
+	int16_t                        handle,
+	PS4000A_CHANNEL_FLAGS          enabledChannelOrPortFlags,
+	double                         timeIntervalRequested,
+	PS4000A_DEVICE_RESOLUTION      resolution,
+	uint16_t                       useEts,
+	uint32_t                       * timebase,
+	double                         * timeIntervalAvailable
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetMinimumTimebaseStateless)
+(
+	int16_t                        handle,
+	PS4000A_CHANNEL_FLAGS          enabledChannelOrPortFlags,
+	uint32_t                       * timebase,
+	double                         * timeInterval,
+	PS4000A_DEVICE_RESOLUTION      resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aCheckForUpdate)
+(
+	int16_t handle,
+	PICO_FIRMWARE_INFO* firmwareInfos,
+    int16_t* nFirmwareInfos,
+    uint16_t* updatesRequired
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aStartFirmwareUpdate)
+(
+	int16_t handle,
+	PicoUpdateFirmwareProgress progress
+	);
+
+#endif

+ 749 - 0
pico-tcp-service/pico-tcp-client/inc/ps5000Api.h

@@ -0,0 +1,749 @@
+/****************************************************************************
+ *
+ * Filename:    ps5000Api.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 5203 and 5204 PC Oscilloscopes.
+ *
+ * Copyright � 2002 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS5000API_H__
+#define __PS5000API_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+/*  If you are dynamically linking ps5000.dll into your project #define DYNLINK here
+ */
+#ifdef DYNLINK
+  #define PREF1 typedef
+  #define PREF2
+  #define PREF3(x) (__stdcall *x)
+#else
+  #define PREF1
+  #ifdef _USRDLL
+    #define PREF2 __declspec(dllexport) __stdcall
+  #else
+    #define PREF2 __declspec(dllimport) __stdcall
+  #endif
+  #define PREF3(x) x
+#endif
+  #define PREF4 __stdcall
+#else
+
+  /* Define a 64-bit integer type */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+#define PS5000_MAX_OVERSAMPLE_8BIT 256
+
+/* Although the PS5000 uses an 8-bit ADC, it is usually possible to
+ * oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+#define PS5000_MAX_VALUE  32512
+#define PS5000_MIN_VALUE -32512
+#define PS5000_LOST_DATA -32768
+
+#define PS5000_EXT_MAX_VALUE  32767
+#define PS5000_EXT_MIN_VALUE -32767
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+#define MAX_DELAY_COUNT 8388607L
+
+#define MAX_SIG_GEN_BUFFER_SIZE 8192
+#define MIN_SIG_GEN_BUFFER_SIZE 10
+#define MIN_DWELL_COUNT         10
+#define MAX_SWEEPS_SHOTS ((1 << 30) - 1)
+
+typedef enum enPS5000Channel
+{
+  PS5000_CHANNEL_A,
+  PS5000_CHANNEL_B,
+  PS5000_CHANNEL_C,
+  PS5000_CHANNEL_D,
+  PS5000_EXTERNAL,
+  PS5000_MAX_CHANNELS = PS5000_EXTERNAL,
+  PS5000_TRIGGER_AUX,
+  PS5000_MAX_TRIGGER_SOURCES
+}  PS5000_CHANNEL;
+
+typedef enum enChannelBufferIndex
+{
+  PS5000_CHANNEL_A_MAX,
+  PS5000_CHANNEL_A_MIN,
+  PS5000_CHANNEL_B_MAX,
+  PS5000_CHANNEL_B_MIN,
+  PS5000_CHANNEL_C_MAX,
+  PS5000_CHANNEL_C_MIN,
+  PS5000_CHANNEL_D_MAX,
+  PS5000_CHANNEL_D_MIN,
+  PS5000_MAX_CHANNEL_BUFFERS
+} PS5000_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS5000Range
+{
+  PS5000_10MV,
+  PS5000_20MV,
+  PS5000_50MV,
+  PS5000_100MV,
+  PS5000_200MV,
+  PS5000_500MV,
+  PS5000_1V,
+  PS5000_2V,
+  PS5000_5V,
+  PS5000_10V,
+  PS5000_20V,
+  PS5000_50V,
+  PS5000_MAX_RANGES
+}  PS5000_RANGE;
+
+
+typedef enum enPS5000EtsMode
+  {
+  PS5000_ETS_OFF,      // ETS disabled
+  PS5000_ETS_FAST,     // Return ready as soon as requested no of interleaves is available
+  PS5000_ETS_SLOW,     // Return ready every time a new set of no_of_cycles is collected
+  PS5000_ETS_MODES_MAX
+  }  PS5000_ETS_MODE;
+
+typedef enum enPS5000TimeUnits
+  {
+  PS5000_FS,
+  PS5000_PS,
+  PS5000_NS,
+  PS5000_US,
+  PS5000_MS,
+  PS5000_S,
+  PS5000_MAX_TIME_UNITS,
+  }  PS5000_TIME_UNITS;
+
+typedef enum enSweepType
+{
+  UP,
+  DOWN,
+  UPDOWN,
+  DOWNUP,
+  MAX_SWEEP_TYPES
+} SWEEP_TYPE;
+
+typedef enum enWaveType
+{
+  PS5000_SINE,
+  PS5000_SQUARE,
+  PS5000_TRIANGLE,
+  PS5000_RAMP_UP,
+  PS5000_RAMP_DOWN,
+  PS5000_SINC,
+  PS5000_GAUSSIAN,
+  PS5000_HALF_SINE,
+  PS5000_DC_VOLTAGE,
+  PS5000_WHITE_NOISE,
+  MAX_WAVE_TYPES
+} WAVE_TYPE;
+
+#define PS5000_SINE_MAX_FREQUENCY        20000000.f
+#define PS5000_SQUARE_MAX_FREQUENCY      20000000.f
+#define PS5000_TRIANGLE_MAX_FREQUENCY    20000000.f
+#define PS5000_SINC_MAX_FREQUENCY        20000000.f
+#define PS5000_RAMP_MAX_FREQUENCY        20000000.f
+#define PS5000_HALF_SINE_MAX_FREQUENCY   20000000.f
+#define PS5000_GAUSSIAN_MAX_FREQUENCY    20000000.f
+#define PS5000_MIN_FREQUENCY                  0.03f
+
+typedef enum enSigGenTrigType
+{
+  SIGGEN_RISING,
+  SIGGEN_FALLING,
+  SIGGEN_GATE_HIGH,
+  SIGGEN_GATE_LOW
+} SIGGEN_TRIG_TYPE;
+
+typedef enum enSigGenTrigSource
+{
+  SIGGEN_NONE,
+  SIGGEN_SCOPE_TRIG,
+  SIGGEN_AUX_IN,
+  SIGGEN_EXT_IN,
+  SIGGEN_SOFT_TRIG
+} SIGGEN_TRIG_SOURCE;
+
+typedef enum enIndexMode
+{
+  SINGLE,
+  DUAL,
+  QUAD,
+  MAX_INDEX_MODES
+} INDEX_MODE;
+
+typedef enum enThresholdMode
+{
+  LEVEL,
+  WINDOW
+} THRESHOLD_MODE;
+
+typedef enum enThresholdDirection
+{
+  ABOVE,
+  BELOW,
+  RISING,
+  FALLING,
+  RISING_OR_FALLING,
+  INSIDE = ABOVE,
+  OUTSIDE = BELOW,
+  ENTER = RISING,
+  EXIT = FALLING,
+  ENTER_OR_EXIT = RISING_OR_FALLING,
+  NONE = RISING
+} THRESHOLD_DIRECTION;
+
+typedef enum enTriggerState
+{
+  CONDITION_DONT_CARE,
+  CONDITION_TRUE,
+  CONDITION_FALSE,
+  CONDITION_MAX
+} TRIGGER_STATE;
+
+#pragma pack(push,1)
+typedef struct tTriggerConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+  TRIGGER_STATE aux;
+  TRIGGER_STATE pulseWidthQualifier;
+} TRIGGER_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPwqConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+  TRIGGER_STATE aux;
+} PWQ_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tTriggerChannelProperties
+{
+  int16_t thresholdMajor;
+  int16_t thresholdMinor;
+  uint16_t hysteresis;
+  PS5000_CHANNEL channel;
+  THRESHOLD_MODE thresholdMode;
+} TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack(pop)
+
+typedef enum enRatioMode
+{
+  RATIO_MODE_NONE = 0,
+  RATIO_MODE_AGGREGATE = 1,
+  RATIO_MODE_DECIMATE = 2,
+  RATIO_MODE_AVERAGE = 4,
+  RATIO_MODE_DISTRIBUTION = 8
+} RATIO_MODE;
+
+typedef enum enPulseWidthType
+{
+  PW_TYPE_NONE,
+  PW_TYPE_LESS_THAN,
+  PW_TYPE_GREATER_THAN,
+  PW_TYPE_IN_RANGE,
+  PW_TYPE_OUT_OF_RANGE
+} PULSE_WIDTH_TYPE;
+
+typedef enum enPS5000ChannelInfo
+{
+  CI_RANGES,
+} PS5000_CHANNEL_INFO;
+
+typedef void (PREF4 *ps5000BlockReady)
+(
+  int16_t      handle,
+  PICO_STATUS  status,
+  void        *pParameter
+);
+
+typedef void (PREF4 *ps5000StreamingReady)
+(
+  int16_t   handle,
+  int32_t   noOfSamples,
+  uint32_t  startIndex,
+  int16_t   overflow,
+  uint32_t  triggerAt,
+  int16_t   triggered,
+  int16_t   autoStop,
+  void     *pParameter
+);
+
+typedef void (PREF4 *ps5000DataReady)
+(
+  int16_t   handle,
+  int32_t   noOfSamples,
+  int16_t   overflow,
+  uint32_t  triggerAt,
+  int16_t   triggered,
+  void     *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000OpenUnit)
+(
+  int16_t *handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000OpenUnitAsync)
+(
+  int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000OpenUnitProgress)
+(
+  int16_t *handle,
+  int16_t *progressPercent,
+  int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetUnitInfo)
+(
+  int16_t    handle,
+  int8_t    *string,
+  int16_t    stringLength,
+  int16_t   *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000FlashLed)
+(
+  int16_t  handle,
+  int16_t  start
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000IsLedFlashing)
+(
+  int16_t  handle,
+  int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000CloseUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000MemorySegments)
+(
+  int16_t   handle,
+  uint16_t  nSegments,
+  int32_t  *nMaxSamples
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetChannel)
+(
+  int16_t         handle,
+  PS5000_CHANNEL  channel,
+  int16_t         enabled,
+  int16_t         dc,
+  PS5000_RANGE    range
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetTimebase)
+(
+  int16_t   handle,
+  uint32_t  timebase,
+  int32_t   noSamples,
+  int32_t  *timeIntervalNanoseconds,
+  int16_t   oversample,
+  int32_t  *maxSamples,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetTimebase2)
+(
+  int16_t   handle,
+  uint32_t  timebase,
+  int32_t   noSamples,
+  float    *timeIntervalNanoseconds,
+  int16_t   oversample,
+  int32_t  *maxSamples,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetSigGenArbitrary)
+(
+  int16_t             handle,
+  int32_t             offsetVoltage,
+  uint32_t            pkToPk,
+  uint32_t            startDeltaPhase,
+  uint32_t            stopDeltaPhase,
+  uint32_t            deltaPhaseIncrement,
+  uint32_t            dwellCount,
+  int16_t            *arbitraryWaveform,
+  int32_t             arbitraryWaveformSize,
+  SWEEP_TYPE          sweepType,
+  int16_t             whiteNoise,
+  INDEX_MODE          indexMode,
+  uint32_t            shots,
+  uint32_t            sweeps,
+  SIGGEN_TRIG_TYPE    triggerType,
+  SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t             extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000SetSigGenBuiltIn)
+(
+  int16_t             handle,
+  int32_t             offsetVoltage,
+  uint32_t            pkToPk,
+  int16_t             waveType,
+  float               startFrequency,
+  float               stopFrequency,
+  float               increment,
+  float               dwellTime,
+  SWEEP_TYPE          sweepType,
+  int16_t             whiteNoise,
+  uint32_t            shots,
+  uint32_t            sweeps,
+  SIGGEN_TRIG_TYPE    triggerType,
+  SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t             extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000SetSigGenBuiltInV2)
+(
+  int16_t             handle,
+  int32_t             offsetVoltage,
+  uint32_t            pkToPk,
+  int16_t             waveType,
+  double              startFrequency,
+  double              stopFrequency,
+  double              increment,
+  double              dwellTime,
+  SWEEP_TYPE          sweepType,
+  int16_t             whiteNoise,
+  uint32_t            shots,
+  uint32_t            sweeps,
+  SIGGEN_TRIG_TYPE    triggerType,
+  SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t             extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000SigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	INDEX_MODE										indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000SigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SigGenSoftwareControl)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetEts)
+(
+  int16_t          handle,
+  PS5000_ETS_MODE  mode,
+  int16_t          etsCycles,
+  int16_t          etsInterleave,
+  int32_t         *sampleTimePicoseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetTriggerChannelProperties)
+(
+  int16_t                     handle,
+  TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                     nChannelProperties,
+  int16_t                     auxOutputEnable,
+  int32_t                     autoTriggerMilliseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetTriggerChannelConditions)
+(
+  int16_t             handle,
+  TRIGGER_CONDITIONS *conditions,
+  int16_t             nConditions
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetTriggerChannelDirections)
+(
+  int16_t              handle,
+  THRESHOLD_DIRECTION  channelA,
+  THRESHOLD_DIRECTION  channelB,
+  THRESHOLD_DIRECTION  channelC,
+  THRESHOLD_DIRECTION  channelD,
+  THRESHOLD_DIRECTION  ext,
+  THRESHOLD_DIRECTION  aux
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetSimpleTrigger)
+(
+  int16_t              handle,
+  int16_t              enable,
+  PS5000_CHANNEL       source,
+  int16_t              threshold,
+  THRESHOLD_DIRECTION  direction,
+  uint32_t             delay,
+  int16_t              autoTrigger_ms
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetTriggerDelay)
+(
+  int16_t   handle,
+  uint32_t  delay
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetPulseWidthQualifier)
+(
+  int16_t              handle,
+  PWQ_CONDITIONS      *conditions,
+  int16_t              nConditions,
+  THRESHOLD_DIRECTION  direction,
+  uint32_t             lower,
+  uint32_t             upper,
+  PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000IsTriggerOrPulseWidthQualifierEnabled)
+(
+  int16_t  handle,
+  int16_t *triggerEnabled,
+  int16_t *pulseWidthQualifierEnabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetTriggerTimeOffset)
+(
+  int16_t            handle,
+  uint32_t          *timeUpper,
+  uint32_t          *timeLower,
+  PS5000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetTriggerTimeOffset64)
+(
+  int16_t            handle,
+  int64_t           *time,
+  PS5000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetValuesTriggerTimeOffsetBulk)
+(
+  int16_t            handle,
+  uint32_t          *timesUpper,
+  uint32_t          *timesLower,
+  PS5000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetValuesTriggerTimeOffsetBulk64)
+(
+  int16_t            handle,
+  int64_t           *times,
+  PS5000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetDataBuffers)
+(
+  int16_t         handle,
+  PS5000_CHANNEL  channel,
+  int16_t        *bufferMax,
+  int16_t        *bufferMin,
+  int32_t         bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetDataBuffer)
+(
+   int16_t         handle,
+   PS5000_CHANNEL  channel,
+   int16_t        *buffer,
+   int32_t         bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetDataBufferBulk)
+(
+  int16_t         handle,
+  PS5000_CHANNEL  channel,
+  int16_t        *buffer,
+  int32_t         bufferLth,
+  uint16_t        waveform
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetEtsTimeBuffer)
+(
+  int16_t  handle,
+  int64_t *buffer,
+  int32_t  bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetEtsTimeBuffers)
+(
+  int16_t   handle,
+  uint32_t *timeUpper,
+  uint32_t *timeLower,
+  int32_t   bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000IsReady)
+(
+  int16_t  handle,
+  int16_t *ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000RunBlock)
+(
+  int16_t           handle,
+  int32_t           noOfPreTriggerSamples,
+  int32_t           noOfPostTriggerSamples,
+  uint32_t          timebase,
+  int16_t           oversample,
+  int32_t          *timeIndisposedMs,
+  uint16_t          segmentIndex,
+  ps5000BlockReady  lpReady,
+  void             *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000RunStreaming)
+(
+  int16_t            handle,
+  uint32_t          *sampleInterval,
+  PS5000_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t           maxPreTriggerSamples,
+  uint32_t           maxPostPreTriggerSamples,
+  int16_t            autoStop,
+  uint32_t           downSampleRatio,
+  uint32_t           overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetStreamingLatestValues)
+(
+  int16_t               handle,
+  ps5000StreamingReady  lpPs5000Ready,
+  void                 *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000NoOfStreamingValues)
+(
+  int16_t   handle,
+  uint32_t *noOfValues
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetMaxDownSampleRatio)
+(
+  int16_t   handle,
+  uint32_t  noOfUnaggreatedSamples,
+  uint32_t *maxDownSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetValues)
+(
+  int16_t   handle,
+  uint32_t  startIndex,
+  uint32_t *noOfSamples,
+  uint32_t  downSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex,
+  int16_t  *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetValuesBulk)
+(
+  int16_t   handle,
+  uint32_t *noOfSamples,
+  uint16_t  fromSegmentIndex,
+  uint16_t  toSegmentIndex,
+  int16_t  *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetValuesAsync)
+(
+  int16_t   handle,
+  uint32_t  startIndex,
+  uint32_t  noOfSamples,
+  uint32_t  downSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex,
+  void     *lpDataReady,
+  void     *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000Stop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000PingUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetNoOfCaptures)
+(
+  int16_t  handle,
+  uint16_t nCaptures
+);
+
+#endif

+ 1249 - 0
pico-tcp-service/pico-tcp-client/inc/ps5000aApi.h

@@ -0,0 +1,1249 @@
+/****************************************************************************
+  *
+  * Filename:    ps5000aApi.h
+  * Author:      MAS
+  * Description:
+  *
+  * This header defines the interface to driver routines for the
+  * PicoScope 5000A, B & D Series PC Oscilloscopes.
+  *
+	* Copyright � 2012 - 2022 Pico Technology Ltd. All rights reserved.
+	*
+  ****************************************************************************/
+#ifndef __PS5000AAPI_H__
+#define __PS5000AAPI_H__
+
+#ifdef __GNUC__
+#define DEPRECATED(text, func) func __attribute__ ((deprecated(text)));
+#elif _MSC_VER
+#define DEPRECATED(text, func) __declspec(deprecated(text)) func;
+#else
+#pragma message("WARNING: You need to implement DEPRECATED for this compiler")
+#define DEPRECATED(func) func;
+#endif
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+#include "PicoVersion.h"
+#include "PicoCallback.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+/* If you are dynamically linking ps5000a.dll into your project #define DYNLINK here
+  */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+  #define PREF4 __stdcall
+#else
+
+  /* Define a 64-bit integer type */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+      #define PREF2
+      #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+#define PS5000A_MAX_VALUE_8BIT  32512
+#define PS5000A_MIN_VALUE_8BIT -32512
+
+#define PS5000A_MAX_VALUE_16BIT  32767
+#define PS5000A_MIN_VALUE_16BIT -32767
+
+#define PS5000A_EXT_MAX_VALUE  32767
+#define PS5000A_EXT_MIN_VALUE -32767
+
+// covers the 5242A/B and 5442A/B
+#define PS5X42A_MAX_SIG_GEN_BUFFER_SIZE  16384
+// covers the 5243A/B and 5443A/B
+#define PS5X43A_MAX_SIG_GEN_BUFFER_SIZE  32768
+// covers the 5244A/B and 5444A/B
+#define PS5X44A_MAX_SIG_GEN_BUFFER_SIZE  49152
+
+// covers the PicoScope 5000D Series
+#define PS5X4XD_MAX_SIG_GEN_BUFFER_SIZE  32768
+
+#define MIN_SIG_GEN_BUFFER_SIZE		        1
+#define MIN_DWELL_COUNT				            3
+#define MAX_SWEEPS_SHOTS		((1 << 30) - 1)
+#define	AWG_DAC_FREQUENCY							200e6
+#define	PS5000AB_DDS_FREQUENCY 				200e6
+#define	PS5000D_DDS_FREQUENCY 				100e6
+#define	AWG_PHASE_ACCUMULATOR  4294967296.0
+
+#define MAX_ANALOGUE_OFFSET_50MV_200MV  0.250f
+#define MIN_ANALOGUE_OFFSET_50MV_200MV -0.250f
+#define MAX_ANALOGUE_OFFSET_500MV_2V    2.500f
+#define MIN_ANALOGUE_OFFSET_500MV_2V   -2.500f
+#define MAX_ANALOGUE_OFFSET_5V_20V        20.f
+#define MIN_ANALOGUE_OFFSET_5V_20V       -20.f
+
+#define PS5244A_MAX_ETS_CYCLES 500  // PS5242A, PS5242B, PS5442A, PS5442B
+#define PS5244A_MAX_ETS_INTERLEAVE  40
+
+#define PS5243A_MAX_ETS_CYCLES 250  // PS5243A, PS5243B, PS5443A, PS5443B
+#define PS5243A_MAX_ETS_INTERLEAVE  20
+
+#define PS5242A_MAX_ETS_CYCLES 125    // PS5242A, PS5242B, PS5442A, PS5442B
+#define PS5242A_MAX_ETS_INTERLEAVE  10
+
+
+#define PS5X44D_MAX_ETS_CYCLES      500    // PS5244D, PS5244DMSO, PS5444D, PS5444DMSO
+#define PS5X44D_MAX_ETS_INTERLEAVE  80
+
+#define PS5X43D_MAX_ETS_CYCLES      250    // PS5243D, PS5243DMSO, PS5443D, PS5443DMSO
+#define PS5X43D_MAX_ETS_INTERLEAVE  40
+
+#define PS5X42D_MAX_ETS_CYCLES      125    // PS5242D, PS5242DMSO, PS5442D, PS5442DMSO
+#define PS5X42D_MAX_ETS_INTERLEAVE  5
+
+
+#define PS5000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN 0xFFFFFFFF
+
+typedef enum enPS5000ADeviceResolution
+{
+  PS5000A_DR_8BIT,
+  PS5000A_DR_12BIT,
+  PS5000A_DR_14BIT,
+  PS5000A_DR_15BIT,
+  PS5000A_DR_16BIT
+} PS5000A_DEVICE_RESOLUTION;
+
+typedef enum enPS5000AExtraOperations
+{
+  PS5000A_ES_OFF,
+  PS5000A_WHITENOISE,
+  PS5000A_PRBS // Pseudo-Random Bit Stream
+} PS5000A_EXTRA_OPERATIONS;
+
+typedef enum enPS5000ABandwidthLimiter
+{
+  PS5000A_BW_FULL,
+  PS5000A_BW_20MHZ,
+} PS5000A_BANDWIDTH_LIMITER;
+
+typedef enum enPS5000ACoupling
+{
+  PS5000A_AC,
+  PS5000A_DC
+} PS5000A_COUPLING;
+
+typedef enum enPS5000AChannel
+{
+  PS5000A_CHANNEL_A,
+  PS5000A_CHANNEL_B,
+  PS5000A_CHANNEL_C,
+  PS5000A_CHANNEL_D,
+  PS5000A_EXTERNAL,
+  PS5000A_MAX_CHANNELS = PS5000A_EXTERNAL,
+  PS5000A_TRIGGER_AUX,
+  PS5000A_MAX_TRIGGER_SOURCES,
+
+	PS5000A_DIGITAL_PORT0 = 0x80, // digital channel 0 - 7
+	PS5000A_DIGITAL_PORT1,             // digital channel 8 - 15
+	PS5000A_DIGITAL_PORT2,             // digital channel 16 - 23
+	PS5000A_DIGITAL_PORT3,             // digital channel 24 - 31
+
+	PS5000A_PULSE_WIDTH_SOURCE = 0x10000000
+
+} PS5000A_CHANNEL;
+
+typedef enum enPS5000AChannelFlags
+{
+	PS5000A_CHANNEL_A_FLAGS = 1,
+	PS5000A_CHANNEL_B_FLAGS = 2,
+	PS5000A_CHANNEL_C_FLAGS = 4,
+	PS5000A_CHANNEL_D_FLAGS = 8,
+
+	PS5000A_PORT0_FLAGS = 65536,
+	PS5000A_PORT1_FLAGS = 131072,
+  PS5000A_PORT2_FLAGS = 262144,
+  PS5000A_PORT3_FLAGS = 524288
+
+}	PS5000A_CHANNEL_FLAGS;
+
+typedef enum enPS5000ADigitalChannel
+{
+	PS5000A_DIGITAL_CHANNEL_0,
+	PS5000A_DIGITAL_CHANNEL_1,
+	PS5000A_DIGITAL_CHANNEL_2,
+	PS5000A_DIGITAL_CHANNEL_3,
+	PS5000A_DIGITAL_CHANNEL_4,
+	PS5000A_DIGITAL_CHANNEL_5,
+	PS5000A_DIGITAL_CHANNEL_6,
+	PS5000A_DIGITAL_CHANNEL_7,
+	PS5000A_DIGITAL_CHANNEL_8,
+	PS5000A_DIGITAL_CHANNEL_9,
+	PS5000A_DIGITAL_CHANNEL_10,
+	PS5000A_DIGITAL_CHANNEL_11,
+	PS5000A_DIGITAL_CHANNEL_12,
+	PS5000A_DIGITAL_CHANNEL_13,
+	PS5000A_DIGITAL_CHANNEL_14,
+	PS5000A_DIGITAL_CHANNEL_15,
+	PS5000A_DIGITAL_CHANNEL_16,
+	PS5000A_DIGITAL_CHANNEL_17,
+	PS5000A_DIGITAL_CHANNEL_18,
+	PS5000A_DIGITAL_CHANNEL_19,
+	PS5000A_DIGITAL_CHANNEL_20,
+	PS5000A_DIGITAL_CHANNEL_21,
+	PS5000A_DIGITAL_CHANNEL_22,
+	PS5000A_DIGITAL_CHANNEL_23,
+	PS5000A_DIGITAL_CHANNEL_24,
+	PS5000A_DIGITAL_CHANNEL_25,
+	PS5000A_DIGITAL_CHANNEL_26,
+	PS5000A_DIGITAL_CHANNEL_27,
+	PS5000A_DIGITAL_CHANNEL_28,
+	PS5000A_DIGITAL_CHANNEL_29,
+	PS5000A_DIGITAL_CHANNEL_30,
+	PS5000A_DIGITAL_CHANNEL_31,
+	PS5000A_MAX_DIGITAL_CHANNELS
+} PS5000A_DIGITAL_CHANNEL;
+
+typedef enum enPS5000ADigitalDirection
+{
+	PS5000A_DIGITAL_DONT_CARE,
+	PS5000A_DIGITAL_DIRECTION_LOW,
+	PS5000A_DIGITAL_DIRECTION_HIGH,
+	PS5000A_DIGITAL_DIRECTION_RISING,
+	PS5000A_DIGITAL_DIRECTION_FALLING,
+	PS5000A_DIGITAL_DIRECTION_RISING_OR_FALLING,
+	PS5000A_DIGITAL_MAX_DIRECTION
+} PS5000A_DIGITAL_DIRECTION;
+
+typedef enum enPS5000ARange
+{
+  PS5000A_10MV,
+  PS5000A_20MV,
+  PS5000A_50MV,
+  PS5000A_100MV,
+  PS5000A_200MV,
+  PS5000A_500MV,
+  PS5000A_1V,
+  PS5000A_2V,
+  PS5000A_5V,
+  PS5000A_10V,
+  PS5000A_20V,
+  PS5000A_50V,
+  PS5000A_MAX_RANGES
+} PS5000A_RANGE;
+
+
+typedef enum enPS5000AEtsMode
+{
+  PS5000A_ETS_OFF,             // ETS disabled
+  PS5000A_ETS_FAST,            // Return ready as soon as requested no of interleaves is available
+  PS5000A_ETS_SLOW,            // Return ready every time a new set of no_of_cycles is collected
+  PS5000A_ETS_MODES_MAX
+} PS5000A_ETS_MODE;
+
+typedef enum enPS5000ATimeUnits
+{
+  PS5000A_FS,
+  PS5000A_PS,
+  PS5000A_NS,
+  PS5000A_US,
+  PS5000A_MS,
+  PS5000A_S,
+  PS5000A_MAX_TIME_UNITS,
+} PS5000A_TIME_UNITS;
+
+typedef enum enPS5000ASweepType
+{
+  PS5000A_UP,
+  PS5000A_DOWN,
+  PS5000A_UPDOWN,
+  PS5000A_DOWNUP,
+  PS5000A_MAX_SWEEP_TYPES
+} PS5000A_SWEEP_TYPE;
+
+typedef enum enPS5000AWaveType
+{
+  PS5000A_SINE,
+  PS5000A_SQUARE,
+  PS5000A_TRIANGLE,
+  PS5000A_RAMP_UP,
+  PS5000A_RAMP_DOWN,
+  PS5000A_SINC,
+  PS5000A_GAUSSIAN,
+  PS5000A_HALF_SINE,
+  PS5000A_DC_VOLTAGE,
+  PS5000A_WHITE_NOISE,
+  PS5000A_MAX_WAVE_TYPES
+} PS5000A_WAVE_TYPE;
+
+
+typedef enum enPS5000AConditionsInfo
+{
+	PS5000A_CLEAR = 0x00000001,
+	PS5000A_ADD = 0x00000002
+} PS5000A_CONDITIONS_INFO;
+
+#define PS5000A_SINE_MAX_FREQUENCY       20000000.f
+#define PS5000A_SQUARE_MAX_FREQUENCY     20000000.f
+#define PS5000A_TRIANGLE_MAX_FREQUENCY   20000000.f
+#define PS5000A_SINC_MAX_FREQUENCY       20000000.f
+#define PS5000A_RAMP_MAX_FREQUENCY       20000000.f
+#define PS5000A_HALF_SINE_MAX_FREQUENCY  20000000.f
+#define PS5000A_GAUSSIAN_MAX_FREQUENCY   20000000.f
+#define PS5000A_MIN_FREQUENCY                 0.03f
+
+typedef enum enPS5000ASigGenTrigType
+{
+  PS5000A_SIGGEN_RISING,
+  PS5000A_SIGGEN_FALLING,
+  PS5000A_SIGGEN_GATE_HIGH,
+  PS5000A_SIGGEN_GATE_LOW
+} PS5000A_SIGGEN_TRIG_TYPE;
+
+typedef enum enPS5000ASigGenTrigSource
+{
+  PS5000A_SIGGEN_NONE,
+  PS5000A_SIGGEN_SCOPE_TRIG,
+  PS5000A_SIGGEN_AUX_IN,
+  PS5000A_SIGGEN_EXT_IN,
+  PS5000A_SIGGEN_SOFT_TRIG
+} PS5000A_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPS5000AIndexMode
+{
+  PS5000A_SINGLE,
+  PS5000A_DUAL,
+  PS5000A_QUAD,
+  PS5000A_MAX_INDEX_MODES
+} PS5000A_INDEX_MODE;
+
+typedef enum enPS5000AThresholdMode
+{
+  PS5000A_LEVEL,
+  PS5000A_WINDOW
+} PS5000A_THRESHOLD_MODE;
+
+typedef enum enPS5000AThresholdDirection
+{
+  PS5000A_ABOVE, //using upper threshold
+  PS5000A_BELOW, //using upper threshold
+  PS5000A_RISING, // using upper threshold
+  PS5000A_FALLING, // using upper threshold
+  PS5000A_RISING_OR_FALLING, // using both threshold
+  PS5000A_ABOVE_LOWER, // using lower threshold
+  PS5000A_BELOW_LOWER, // using lower threshold
+  PS5000A_RISING_LOWER,    // using lower threshold
+  PS5000A_FALLING_LOWER,   // using lower threshold
+
+  // Windowing using both thresholds
+  PS5000A_INSIDE = PS5000A_ABOVE,
+  PS5000A_OUTSIDE = PS5000A_BELOW,
+  PS5000A_ENTER = PS5000A_RISING,
+  PS5000A_EXIT = PS5000A_FALLING,
+  PS5000A_ENTER_OR_EXIT = PS5000A_RISING_OR_FALLING,
+  PS5000A_POSITIVE_RUNT = 9,
+   PS5000A_NEGATIVE_RUNT,
+
+  // no trigger set
+  PS5000A_NONE = PS5000A_RISING} PS5000A_THRESHOLD_DIRECTION;
+
+
+typedef enum enPS5000ATriggerState
+{
+  PS5000A_CONDITION_DONT_CARE,
+  PS5000A_CONDITION_TRUE,
+  PS5000A_CONDITION_FALSE,
+  PS5000A_CONDITION_MAX
+} PS5000A_TRIGGER_STATE;
+
+typedef enum enPS5000ATriggerWithinPreTrigger
+{
+  PS5000A_DISABLE,
+  PS5000A_ARM
+} PS5000A_TRIGGER_WITHIN_PRE_TRIGGER;
+
+#pragma pack(push, 1)
+typedef struct tPS5000ATriggerInfo
+{
+	PICO_STATUS		status;
+	uint32_t 	segmentIndex;
+	uint32_t 	triggerIndex;
+	int64_t		triggerTime;
+	int16_t		timeUnits;
+	int16_t		reserved0;
+	uint64_t	timeStampCounter;
+} PS5000A_TRIGGER_INFO;
+
+typedef struct tPS5000ATriggerConditions
+{
+  PS5000A_TRIGGER_STATE channelA;
+  PS5000A_TRIGGER_STATE channelB;
+  PS5000A_TRIGGER_STATE channelC;
+  PS5000A_TRIGGER_STATE channelD;
+  PS5000A_TRIGGER_STATE external;
+  PS5000A_TRIGGER_STATE aux;
+  PS5000A_TRIGGER_STATE pulseWidthQualifier;
+} PS5000A_TRIGGER_CONDITIONS;
+
+typedef struct tPS5000ACondition
+{
+	PS5000A_CHANNEL   		source;
+	PS5000A_TRIGGER_STATE condition;
+} PS5000A_CONDITION;
+
+typedef struct tPS5000ADirection
+{
+	PS5000A_CHANNEL							source;
+	PS5000A_THRESHOLD_DIRECTION direction;
+	PS5000A_THRESHOLD_MODE			mode;
+} PS5000A_DIRECTION;
+
+typedef struct tPS5000APwqConditions
+{
+  PS5000A_TRIGGER_STATE channelA;
+  PS5000A_TRIGGER_STATE channelB;
+  PS5000A_TRIGGER_STATE channelC;
+  PS5000A_TRIGGER_STATE channelD;
+  PS5000A_TRIGGER_STATE external;
+  PS5000A_TRIGGER_STATE aux;
+} PS5000A_PWQ_CONDITIONS;
+
+typedef struct tPS5000AScalingFactors
+{
+	PS5000A_CHANNEL source;
+	PS5000A_RANGE   range;
+	int16_t         offset;
+	double          scalingFactor;
+}PS5000A_SCALING_FACTORS_VALUES;
+
+typedef struct tPS5000ATriggerChannelProperties
+{
+  int16_t                   thresholdUpper;
+  uint16_t          thresholdUpperHysteresis;
+  int16_t                   thresholdLower;
+  uint16_t          thresholdLowerHysteresis;
+  PS5000A_CHANNEL         channel;
+  PS5000A_THRESHOLD_MODE  thresholdMode;
+} PS5000A_TRIGGER_CHANNEL_PROPERTIES;
+
+typedef struct tPS5000ATriggerChannelPropertiesV2
+{
+	int16_t           thresholdUpper;
+	uint16_t          thresholdUpperHysteresis;
+	int16_t                   thresholdLower;
+	uint16_t          thresholdLowerHysteresis;
+	PS5000A_CHANNEL         channel;
+} PS5000A_TRIGGER_CHANNEL_PROPERTIES_V2;
+
+typedef struct tPS5000ADigitalChannelDirections
+{
+	PS5000A_DIGITAL_CHANNEL   channel;
+	PS5000A_DIGITAL_DIRECTION direction;
+} PS5000A_DIGITAL_CHANNEL_DIRECTIONS;
+
+#pragma pack(pop)
+
+typedef enum enPS5000ARatioMode
+{
+  PS5000A_RATIO_MODE_NONE         = 0,
+  PS5000A_RATIO_MODE_AGGREGATE    = 1,
+  PS5000A_RATIO_MODE_DECIMATE     = 2,
+  PS5000A_RATIO_MODE_AVERAGE      = 4,
+  PS5000A_RATIO_MODE_DISTRIBUTION = 8
+} PS5000A_RATIO_MODE;
+
+typedef enum enPS5000APulseWidthType
+{
+  PS5000A_PW_TYPE_NONE,
+  PS5000A_PW_TYPE_LESS_THAN,
+  PS5000A_PW_TYPE_GREATER_THAN,
+  PS5000A_PW_TYPE_IN_RANGE,
+  PS5000A_PW_TYPE_OUT_OF_RANGE
+} PS5000A_PULSE_WIDTH_TYPE;
+
+typedef enum enPS5000AChannelInfo
+{
+  PS5000A_CI_RANGES,
+} PS5000A_CHANNEL_INFO;
+
+
+typedef void (PREF4 *ps5000aBlockReady)
+(
+  int16_t        handle,
+  PICO_STATUS  status,
+  void        *pParameter
+);
+
+typedef void (PREF4 *ps5000aStreamingReady)
+(
+  int16_t          handle,
+  int32_t           noOfSamples,
+  uint32_t  startIndex,
+  int16_t          overflow,
+  uint32_t  triggerAt,
+  int16_t          triggered,
+  int16_t          autoStop,
+  void          *pParameter
+);
+
+typedef void (PREF4 *ps5000aDataReady)
+(
+  int16_t          handle,
+  PICO_STATUS    status,
+  uint32_t  noOfSamples,
+  int16_t          overflow,
+  void          *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aOpenUnit)(
+  int16_t                     *handle,
+  int8_t                      *serial,
+  PS5000A_DEVICE_RESOLUTION  resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aOpenUnitAsync)
+(
+  int16_t                     *status,
+  int8_t                      *serial,
+  PS5000A_DEVICE_RESOLUTION  resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aOpenUnitProgress)
+(
+  int16_t *handle,
+  int16_t *progressPercent,
+  int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetUnitInfo)
+(
+  int16_t      handle,
+  int8_t		*  string,
+  int16_t      stringLength,
+  int16_t     *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aFlashLed)
+(
+  int16_t  handle,
+  int16_t  start
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aIsLedFlashing)
+(
+  int16_t  handle,
+  int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aCloseUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aMemorySegments)
+(
+  int16_t          handle,
+  uint32_t  nSegments,
+  int32_t          *nMaxSamples
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetChannel)
+(
+  int16_t             handle,
+  PS5000A_CHANNEL   channel,
+  int16_t             enabled,
+  PS5000A_COUPLING  type,
+  PS5000A_RANGE     range,
+  float             analogOffset
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetDigitalPort)
+(
+	int16_t                 handle,
+	PS5000A_CHANNEL				  port,
+	int16_t                 enabled,
+	int16_t                 logicLevel
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetBandwidthFilter)
+(
+  int16_t                      handle,
+  PS5000A_CHANNEL            channel,
+  PS5000A_BANDWIDTH_LIMITER  bandwidth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetTimebase)
+(
+  int16_t          handle,
+  uint32_t  timebase,
+  int32_t           noSamples,
+  int32_t          *timeIntervalNanoseconds,
+  int32_t          *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetTimebase2)
+(
+  int16_t          handle,
+  uint32_t  timebase,
+  int32_t           noSamples,
+  float         *timeIntervalNanoseconds,
+  int32_t          *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aNearestSampleIntervalStateless)
+(
+	int16_t   handle,
+	PS5000A_CHANNEL_FLAGS   enabledChannelOrPortFlags,
+	double		timeIntervalRequested,
+	PS5000A_DEVICE_RESOLUTION resolution,
+	uint16_t	useEts,
+	uint32_t	* timebase,
+	double		* timeIntervalAvailable
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aGetMinimumTimebaseStateless)
+(
+	int16_t		handle,
+	PS5000A_CHANNEL_FLAGS		enabledChannelOrPortFlags,
+	uint32_t	* timebase,
+	double		* timeInterval,
+	PS5000A_DEVICE_RESOLUTION resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aChannelCombinationsStateless)
+(
+	int16_t handle,
+	PS5000A_CHANNEL_FLAGS * channelOrPortFlagsCombinations,
+	uint32_t * nChannelCombinations,
+	PS5000A_DEVICE_RESOLUTION resolution,
+	uint32_t timebase,
+	int16_t hasDcPowerSupplyConnected
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetSigGenArbitrary)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  uint32_t               startDeltaPhase,
+  uint32_t               stopDeltaPhase,
+  uint32_t               deltaPhaseIncrement,
+  uint32_t               dwellCount,
+  int16_t                      *arbitraryWaveform,
+  int32_t                        arbitraryWaveformSize,
+  PS5000A_SWEEP_TYPE          sweepType,
+  PS5000A_EXTRA_OPERATIONS    operation,
+  PS5000A_INDEX_MODE          indexMode,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS5000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS5000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetSigGenBuiltIn)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  PS5000A_WAVE_TYPE           waveType,
+  float                       startFrequency,
+  float                       stopFrequency,
+  float                       increment,
+  float                       dwellTime,
+  PS5000A_SWEEP_TYPE          sweepType,
+  PS5000A_EXTRA_OPERATIONS    operation,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS5000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS5000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetSigGenBuiltInV2)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  PS5000A_WAVE_TYPE           waveType,
+  double                       startFrequency,
+  double                       stopFrequency,
+  double                       increment,
+  double                       dwellTime,
+  PS5000A_SWEEP_TYPE          sweepType,
+  PS5000A_EXTRA_OPERATIONS    operation,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS5000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS5000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetSigGenPropertiesArbitrary)
+(
+  int16_t                       handle,
+  uint32_t               startDeltaPhase,
+  uint32_t               stopDeltaPhase,
+  uint32_t               deltaPhaseIncrement,
+  uint32_t               dwellCount,
+  PS5000A_SWEEP_TYPE          sweepType,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS5000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS5000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetSigGenPropertiesBuiltIn)
+(
+  int16_t                       handle,
+	double                       startFrequency,
+	double                       stopFrequency,
+	double                       increment,
+	double                       dwellTime,
+  PS5000A_SWEEP_TYPE          sweepType,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS5000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS5000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	PS5000A_INDEX_MODE						indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSigGenSoftwareControl)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetEts)
+(
+  int16_t             handle,
+  PS5000A_ETS_MODE  mode,
+  int16_t             etsCycles,
+  int16_t             etsInterleave,
+  int32_t             *sampleTimePicoseconds
+);
+
+PREF0 DEPRECATED("this function is marked as deprecated use ps5000aSetTriggerChannelPropertiesV2", PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetTriggerChannelProperties)
+(
+	int16_t                               handle,
+	PS5000A_TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+	int16_t                               nChannelProperties,
+	int16_t                               auxOutputEnable,
+	int32_t                                autoTriggerMilliseconds
+	))
+
+	PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetTriggerChannelPropertiesV2)
+	(
+		int16_t																	handle,
+		PS5000A_TRIGGER_CHANNEL_PROPERTIES_V2 *	channelProperties,
+		int16_t																	nChannelProperties,
+		int16_t																	auxOutputEnable
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetAutoTriggerMicroSeconds)
+(
+	int16_t	 handle,
+	uint64_t autoTriggerMicroseconds
+	);
+
+
+PREF0 DEPRECATED("this function is marked as deprecated use ps5000aSetTriggerChannelConditionsV2", PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetTriggerChannelConditions)
+(
+	int16_t                       handle,
+	PS5000A_TRIGGER_CONDITIONS *conditions,
+	int16_t                       nConditions
+	))
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetTriggerChannelConditionsV2)
+(
+	int16_t												handle,
+	PS5000A_CONDITION					*		conditions,
+	int16_t												nConditions,
+	PS5000A_CONDITIONS_INFO				info
+	);
+
+PREF0 DEPRECATED("this function is marked as deprecated use ps5000aSetTriggerChannelDirectionsV2", PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetTriggerChannelDirections)
+(
+  int16_t                      handle,
+  PS5000A_THRESHOLD_DIRECTION  channelA,
+  PS5000A_THRESHOLD_DIRECTION  channelB,
+  PS5000A_THRESHOLD_DIRECTION  channelC,
+  PS5000A_THRESHOLD_DIRECTION  channelD,
+  PS5000A_THRESHOLD_DIRECTION  ext,
+  PS5000A_THRESHOLD_DIRECTION  aux
+))
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetTriggerChannelDirectionsV2)
+(
+	int16_t								handle,
+	PS5000A_DIRECTION	*		directions,
+	uint16_t							nDirections
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetSimpleTrigger)
+(
+  int16_t                        handle,
+  int16_t                        enable,
+  PS5000A_CHANNEL              channel,
+  int16_t                        threshold,
+  PS5000A_THRESHOLD_DIRECTION  direction,
+  uint32_t                delay,
+  int16_t                        autoTrigger_ms
+);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetTriggerDigitalPortProperties)
+(
+	int16_t                               handle,
+	PS5000A_DIGITAL_CHANNEL_DIRECTIONS *  directions,
+	int16_t                               nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetPulseWidthDigitalPortProperties)
+(
+	int16_t                               handle,
+	PS5000A_DIGITAL_CHANNEL_DIRECTIONS *  directions,
+	int16_t                               nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetTriggerDelay)
+(
+   int16_t          handle,
+   uint32_t  delay
+);
+
+PREF0 DEPRECATED("this function is marked as deprecated use ps5000aSetPulseWidthQualifierProperties, ps5000aSetPulseWidthQualifierConditions, ps5000aSetPulseWidthQualifierDirections", PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetPulseWidthQualifier)
+(
+  int16_t                        handle,
+  PS5000A_PWQ_CONDITIONS      *conditions,
+  int16_t                        nConditions,
+  PS5000A_THRESHOLD_DIRECTION  direction,
+  uint32_t                lower,
+  uint32_t                upper,
+  PS5000A_PULSE_WIDTH_TYPE     type
+))
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetPulseWidthQualifierProperties)
+(
+	int16_t														handle,
+	uint32_t										lower,
+	uint32_t										upper,
+	PS5000A_PULSE_WIDTH_TYPE				type
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetPulseWidthQualifierConditions)
+(
+	int16_t												handle,
+	PS5000A_CONDITION					*	conditions,
+	int16_t												nConditions,
+	PS5000A_CONDITIONS_INFO			info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetPulseWidthQualifierDirections)
+(
+	int16_t	handle,
+	PS5000A_DIRECTION * directions,
+	int16_t nDirections
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aIsTriggerOrPulseWidthQualifierEnabled)
+(
+  int16_t  handle,
+  int16_t *triggerEnabled,
+  int16_t *pulseWidthQualifierEnabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetTriggerTimeOffset)
+(
+  int16_t               handle,
+  uint32_t      *timeUpper,
+  uint32_t      *timeLower,
+  PS5000A_TIME_UNITS *timeUnits,
+  uint32_t       segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetTriggerTimeOffset64)
+(
+  int16_t               handle,
+  int64_t            *time,
+  PS5000A_TIME_UNITS *timeUnits,
+  uint32_t       segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesTriggerTimeOffsetBulk)
+(
+  int16_t               handle,
+  uint32_t      *timesUpper,
+  uint32_t      *timesLower,
+  PS5000A_TIME_UNITS *timeUnits,
+  uint32_t       fromSegmentIndex,
+  uint32_t       toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesTriggerTimeOffsetBulk64)
+(
+  int16_t               handle,
+  int64_t            *times,
+  PS5000A_TIME_UNITS *timeUnits,
+  uint32_t       fromSegmentIndex,
+  uint32_t       toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetDataBuffers)
+(
+  int16_t               handle,
+  PS5000A_CHANNEL     source,
+  int16_t              *bufferMax,
+  int16_t              *bufferMin,
+  int32_t                bufferLth,
+  uint32_t       segmentIndex,
+  PS5000A_RATIO_MODE  mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetDataBuffer)
+(
+  int16_t               handle,
+  PS5000A_CHANNEL     source,
+  int16_t              *buffer,
+  int32_t                bufferLth,
+  uint32_t       segmentIndex,
+  PS5000A_RATIO_MODE  mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetUnscaledDataBuffers)
+(
+	int16_t               handle,
+	PS5000A_CHANNEL     source,
+	int8_t              *bufferMax,
+	int8_t              *bufferMin,
+	int32_t                bufferLth,
+	uint32_t      segmentIndex,
+	PS5000A_RATIO_MODE  mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetEtsTimeBuffer)
+(
+  int16_t     handle,
+  int64_t  *buffer,
+  int32_t      bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetEtsTimeBuffers)
+(
+  int16_t          handle,
+  uint32_t *timeUpper,
+  uint32_t *timeLower,
+  int32_t           bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aIsReady)
+(
+		int16_t handle,
+		int16_t * ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aRunBlock)
+(
+  int16_t              handle,
+  int32_t               noOfPreTriggerSamples,
+  int32_t               noOfPostTriggerSamples,
+  uint32_t      timebase,
+  int32_t              *timeIndisposedMs,
+  uint32_t      segmentIndex,
+  ps5000aBlockReady  lpReady,
+  void              *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aRunStreaming)
+(
+  int16_t               handle,
+  uint32_t      *sampleInterval,
+  PS5000A_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t       maxPreTriggerSamples,
+  uint32_t       maxPostTriggerSamples,
+  int16_t               autoStop,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetStreamingLatestValues)
+(
+  int16_t                  handle,
+  ps5000aStreamingReady  lpPs5000aReady,
+  void                  *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aNoOfStreamingValues)
+(
+  int16_t          handle,
+  uint32_t *noOfValues
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetMaxDownSampleRatio)
+(
+  int16_t               handle,
+  uint32_t       noOfUnaggreatedSamples,
+  uint32_t      *maxDownSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValues)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       segmentIndex,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesAsync)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t       noOfSamples,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       segmentIndex,
+  void               *lpDataReady,
+  void               *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesBulk)
+(
+  int16_t               handle,
+  uint32_t      *noOfSamples,
+  uint32_t       fromSegmentIndex,
+  uint32_t       toSegmentIndex,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesOverlapped)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       segmentIndex,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesOverlappedBulk)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       fromSegmentIndex,
+  uint32_t       toSegmentIndex,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aTriggerWithinPreTriggerSamples)
+(
+  int16_t handle,
+  PS5000A_TRIGGER_WITHIN_PRE_TRIGGER state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetTriggerInfoBulk)
+(
+  int16_t										handle,
+  PS5000A_TRIGGER_INFO	*	triggerInfo,
+  uint32_t						fromSegmentIndex,
+  uint32_t						toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aEnumerateUnits)
+(
+  int16_t *count,
+  int8_t  *serials,
+  int16_t *serialLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetChannelInformation)
+(
+  int16_t                 handle,
+  PS5000A_CHANNEL_INFO  info,
+  int32_t                   probe,
+  int32_t                  *ranges,
+  int32_t                  *length,
+  int32_t                   channels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aMaximumValue)
+(
+  int16_t  handle,
+  int16_t *value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aMinimumValue)
+(
+  int16_t  handle,
+  int16_t * value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetAnalogueOffset)
+(
+  int16_t             handle,
+  PS5000A_RANGE     range,
+  PS5000A_COUPLING  coupling,
+  float            *maximumVoltage,
+  float            *minimumVoltage
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetMaxSegments)
+(
+  int16_t          handle,
+  uint32_t *maxSegments
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aChangePowerSource)
+(
+  int16_t        handle,
+  PICO_STATUS  powerState
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aCurrentPowerSource)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aStop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aPingUnit)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetNoOfCaptures)
+(
+  int16_t          handle,
+  uint32_t  nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetNoOfCaptures)
+(
+  int16_t          handle,
+  uint32_t *nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetNoOfProcessedCaptures)
+(
+  int16_t          handle,
+  uint32_t *nProcessedCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetDeviceResolution)
+(
+  int16_t                      handle,
+  PS5000A_DEVICE_RESOLUTION  resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetDeviceResolution)
+(
+  int16_t                      handle,
+  PS5000A_DEVICE_RESOLUTION *resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aGetScalingValues)
+(
+	int16_t	handle,
+	PS5000A_SCALING_FACTORS_VALUES *scalingValues,
+	int16_t nChannels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aCheckForUpdate)
+(
+	int16_t	handle,
+	PICO_VERSION * current,
+	PICO_VERSION * update,
+	uint16_t		 * updateRequired
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aStartFirmwareUpdate)
+(
+	int16_t	handle,
+	PicoUpdateFirmwareProgress progress
+);
+
+#endif

+ 962 - 0
pico-tcp-service/pico-tcp-client/inc/ps6000Api.h

@@ -0,0 +1,962 @@
+/****************************************************************************
+ *
+ * Filename:    ps6000Api.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 6000 Series PC Oscilloscopes.
+ *
+ * Copyright � 2009 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS6000API_H__
+#define __PS6000API_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+// If you are dynamically linking ps6000.dll into your project #define DYNLINK here
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+  #define PREF4 __stdcall
+#else
+
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+#define PS6000_MAX_OVERSAMPLE_8BIT 256
+
+/* Although the PS6000 uses an 8-bit ADC, it is usually possible to
+ * oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+#define PS6000_MAX_VALUE 32512
+#define PS6000_MIN_VALUE -32512
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+
+#define MAX_SIG_GEN_BUFFER_SIZE  16384
+#define PS640X_C_D_MAX_SIG_GEN_BUFFER_SIZE 65536
+
+#define MIN_SIG_GEN_BUFFER_SIZE        1
+#define MIN_DWELL_COUNT                3
+#define MAX_SWEEPS_SHOTS ((1 << 30) - 1)
+
+#define MAX_WAVEFORMS_PER_SECOND  1000000
+
+// supported by the PS6402 and PS6403
+// for other devices use GetAnalogueOffset also
+// PS6402 and PS6403 supports this function
+#define MAX_ANALOGUE_OFFSET_50MV_200MV  0.500f
+#define MIN_ANALOGUE_OFFSET_50MV_200MV -0.500f
+#define MAX_ANALOGUE_OFFSET_500MV_2V    2.500f
+#define MIN_ANALOGUE_OFFSET_500MV_2V   -2.500f
+#define MAX_ANALOGUE_OFFSET_5V_20V        20.f
+#define MIN_ANALOGUE_OFFSET_5V_20V       -20.f
+
+#define PS6000_MAX_ETS_CYCLES 250
+#define PS6000_MAX_INTERLEAVE  50
+
+typedef enum enPS6000ExternalFrequency
+{
+  PS6000_FREQUENCY_OFF,
+  PS6000_FREQUENCY_5MHZ,
+  PS6000_FREQUENCY_10MHZ,
+  PS6000_FREQUENCY_20MHZ,
+  PS6000_FREQUENCY_25MHZ,
+  PS6000_MAX_FREQUENCIES
+} PS6000_EXTERNAL_FREQUENCY;
+
+typedef enum  enPS6000BandwidthLimiter
+{
+  PS6000_BW_FULL,
+  PS6000_BW_20MHZ,
+  PS6000_BW_25MHZ,
+} PS6000_BANDWIDTH_LIMITER;
+
+typedef enum enPS6000Channel
+{
+  PS6000_CHANNEL_A,
+  PS6000_CHANNEL_B,
+  PS6000_CHANNEL_C,
+  PS6000_CHANNEL_D,
+  PS6000_EXTERNAL,
+  PS6000_MAX_CHANNELS = PS6000_EXTERNAL,
+  PS6000_TRIGGER_AUX,
+  PS6000_MAX_TRIGGER_SOURCES
+}  PS6000_CHANNEL;
+
+typedef enum enPS6000ChannelBufferIndex
+{
+  PS6000_CHANNEL_A_MAX,
+  PS6000_CHANNEL_A_MIN,
+  PS6000_CHANNEL_B_MAX,
+  PS6000_CHANNEL_B_MIN,
+  PS6000_CHANNEL_C_MAX,
+  PS6000_CHANNEL_C_MIN,
+  PS6000_CHANNEL_D_MAX,
+  PS6000_CHANNEL_D_MIN,
+  PS6000_MAX_CHANNEL_BUFFERS
+} PS6000_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS6000Range
+{
+  PS6000_10MV,
+  PS6000_20MV,
+  PS6000_50MV,
+  PS6000_100MV,
+  PS6000_200MV,
+  PS6000_500MV,
+  PS6000_1V,
+  PS6000_2V,
+  PS6000_5V,
+  PS6000_10V,
+  PS6000_20V,
+  PS6000_50V,
+  PS6000_MAX_RANGES
+}  PS6000_RANGE;
+
+
+typedef enum enPS6000Coupling
+{
+  PS6000_AC,
+  PS6000_DC_1M,
+  PS6000_DC_50R
+} PS6000_COUPLING;
+
+typedef enum enPS6000EtsMode
+{
+  PS6000_ETS_OFF,             // ETS disabled
+  PS6000_ETS_FAST,            // Return ready as soon as requested no of interleaves is available
+  PS6000_ETS_SLOW,            // Return ready every time a new set of no_of_cycles is collected
+  PS6000_ETS_MODES_MAX
+}  PS6000_ETS_MODE;
+
+typedef enum enPS6000TimeUnits
+{
+  PS6000_FS,
+  PS6000_PS,
+  PS6000_NS,
+  PS6000_US,
+  PS6000_MS,
+  PS6000_S,
+  PS6000_MAX_TIME_UNITS,
+}  PS6000_TIME_UNITS;
+
+typedef enum enPS6000SweepType
+{
+  PS6000_UP,
+  PS6000_DOWN,
+  PS6000_UPDOWN,
+  PS6000_DOWNUP,
+  PS6000_MAX_SWEEP_TYPES
+} PS6000_SWEEP_TYPE;
+
+typedef enum enPS6000WaveType
+{
+  PS6000_SINE,
+  PS6000_SQUARE,
+  PS6000_TRIANGLE,
+  PS6000_RAMP_UP,
+  PS6000_RAMP_DOWN,
+  PS6000_SINC,
+  PS6000_GAUSSIAN,
+  PS6000_HALF_SINE,
+  PS6000_DC_VOLTAGE,
+  PS6000_MAX_WAVE_TYPES
+} PS6000_WAVE_TYPE;
+
+typedef enum enPS6000ExtraOperations
+{
+  PS6000_ES_OFF,
+  PS6000_WHITENOISE,
+  PS6000_PRBS // Pseudo-Random Bit Stream
+} PS6000_EXTRA_OPERATIONS;
+
+#define PS6000_PRBS_MAX_FREQUENCY       20000000.f
+#define PS6000_SINE_MAX_FREQUENCY       20000000.f
+#define PS6000_SQUARE_MAX_FREQUENCY     20000000.f
+#define PS6000_TRIANGLE_MAX_FREQUENCY   20000000.f
+#define PS6000_SINC_MAX_FREQUENCY       20000000.f
+#define PS6000_RAMP_MAX_FREQUENCY       20000000.f
+#define PS6000_HALF_SINE_MAX_FREQUENCY  20000000.f
+#define PS6000_GAUSSIAN_MAX_FREQUENCY   20000000.f
+#define PS6000_MIN_FREQUENCY                 0.03f
+
+typedef enum enPS6000SigGenTrigType
+{
+  PS6000_SIGGEN_RISING,
+  PS6000_SIGGEN_FALLING,
+  PS6000_SIGGEN_GATE_HIGH,
+  PS6000_SIGGEN_GATE_LOW
+} PS6000_SIGGEN_TRIG_TYPE;
+
+typedef enum enPS6000SigGenTrigSource
+{
+  PS6000_SIGGEN_NONE,
+  PS6000_SIGGEN_SCOPE_TRIG,
+  PS6000_SIGGEN_AUX_IN,
+  PS6000_SIGGEN_EXT_IN,
+  PS6000_SIGGEN_SOFT_TRIG,
+  PS6000_SIGGEN_TRIGGER_RAW
+} PS6000_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPS6000IndexMode
+{
+  PS6000_SINGLE,
+  PS6000_DUAL,
+  PS6000_QUAD,
+  PS6000_MAX_INDEX_MODES
+} PS6000_INDEX_MODE;
+
+typedef enum enPS6000ThresholdMode
+{
+  PS6000_LEVEL,
+  PS6000_WINDOW
+} PS6000_THRESHOLD_MODE;
+
+typedef enum enPS6000ThresholdDirection
+{
+  PS6000_ABOVE,             //using upper threshold
+  PS6000_BELOW,							// using upper threshold
+  PS6000_RISING,            // using upper threshold
+  PS6000_FALLING,           // using upper threshold
+  PS6000_RISING_OR_FALLING, // using upper threshold
+  PS6000_ABOVE_LOWER,       // using lower threshold
+  PS6000_BELOW_LOWER,       // using lower threshold
+  PS6000_RISING_LOWER,      // using lower threshold
+  PS6000_FALLING_LOWER,     // using lower threshold
+  // Windowing using both thresholds
+  PS6000_INSIDE        = PS6000_ABOVE,
+  PS6000_OUTSIDE       = PS6000_BELOW,
+  PS6000_ENTER         = PS6000_RISING,
+  PS6000_EXIT          = PS6000_FALLING,
+  PS6000_ENTER_OR_EXIT = PS6000_RISING_OR_FALLING,
+  PS6000_POSITIVE_RUNT = 9,
+  PS6000_NEGATIVE_RUNT,
+  // no trigger set
+  PS6000_NONE = PS6000_RISING
+} PS6000_THRESHOLD_DIRECTION;
+
+typedef enum enPS6000TriggerState
+{
+  PS6000_CONDITION_DONT_CARE,
+  PS6000_CONDITION_TRUE,
+  PS6000_CONDITION_FALSE,
+  PS6000_CONDITION_MAX
+} PS6000_TRIGGER_STATE;
+
+#pragma pack(push,1)
+typedef struct tPS6000TriggerInfo
+{
+	PICO_STATUS	status;
+	uint32_t	segmentIndex;
+	uint32_t	triggerIndex;
+	int64_t		triggerTime;
+	int16_t		timeUnits;
+	int16_t		reserved0;
+	uint64_t	timeStampCounter;
+} PS6000_TRIGGER_INFO;
+
+typedef struct tPS6000TriggerConditions
+{
+  PS6000_TRIGGER_STATE channelA;
+  PS6000_TRIGGER_STATE channelB;
+  PS6000_TRIGGER_STATE channelC;
+  PS6000_TRIGGER_STATE channelD;
+  PS6000_TRIGGER_STATE external;
+  PS6000_TRIGGER_STATE aux;
+  PS6000_TRIGGER_STATE pulseWidthQualifier;
+} PS6000_TRIGGER_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS6000PwqConditions
+{
+  PS6000_TRIGGER_STATE channelA;
+  PS6000_TRIGGER_STATE channelB;
+  PS6000_TRIGGER_STATE channelC;
+  PS6000_TRIGGER_STATE channelD;
+  PS6000_TRIGGER_STATE external;
+  PS6000_TRIGGER_STATE aux;
+} PS6000_PWQ_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS6000TriggerChannelProperties
+{
+  int16_t            thresholdUpper;
+  uint16_t  hysteresisUpper;
+  int16_t            thresholdLower;
+  uint16_t  hysteresisLower;
+  PS6000_CHANNEL  channel;
+  PS6000_THRESHOLD_MODE  thresholdMode;
+} PS6000_TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack(pop)
+
+typedef enum enPS6000RatioMode
+{
+  PS6000_RATIO_MODE_NONE,
+  PS6000_RATIO_MODE_AGGREGATE    = 1,
+  PS6000_RATIO_MODE_AVERAGE      = 2,
+  PS6000_RATIO_MODE_DECIMATE     = 4,
+  PS6000_RATIO_MODE_DISTRIBUTION = 8
+} PS6000_RATIO_MODE;
+
+typedef enum enPS6000PulseWidthType
+{
+  PS6000_PW_TYPE_NONE,
+  PS6000_PW_TYPE_LESS_THAN,
+  PS6000_PW_TYPE_GREATER_THAN,
+  PS6000_PW_TYPE_IN_RANGE,
+  PS6000_PW_TYPE_OUT_OF_RANGE
+} PS6000_PULSE_WIDTH_TYPE;
+
+typedef enum enPS6000Temperatures
+{
+	PS6000_WHAT_ARE_AVAILABLE = 0,
+	PS6000_INTERNAL_TEMPERATURE = 1
+} PS6000_TEMPERATURES;
+
+typedef void (PREF4 *ps6000BlockReady)
+(
+  int16_t        handle,
+  PICO_STATUS  status,
+  void        *pParameter
+);
+
+typedef void (PREF4 *ps6000StreamingReady)
+(
+  int16_t          handle,
+  uint32_t  noOfSamples,
+  uint32_t  startIndex,
+  int16_t          overflow,
+  uint32_t  triggerAt,
+  int16_t          triggered,
+  int16_t          autoStop,
+  void          *pParameter
+);
+
+typedef void (PREF4 *ps6000DataReady)
+(
+  int16_t          handle,
+  PICO_STATUS    status,
+  uint32_t  noOfSamples,
+  int16_t          overflow,
+  void          *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000OpenUnit)
+(
+  int16_t *handle,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000OpenUnitAsync)
+(
+  int16_t *status,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000OpenUnitProgress)
+(
+  int16_t *handle,
+  int16_t *progressPercent,
+  int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetUnitInfo)
+(
+  int16_t      handle,
+  int8_t      *string,
+  int16_t      stringLength,
+  int16_t     *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000FlashLed)
+(
+  int16_t  handle,
+  int16_t  start
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000CloseUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000MemorySegments)
+(
+  int16_t          handle,
+  uint32_t  nSegments,
+  uint32_t *nMaxSamples
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetChannel)
+(
+  int16_t                     handle,
+  PS6000_CHANNEL            channel,
+  int16_t                     enabled,
+  PS6000_COUPLING           type,
+  PS6000_RANGE              range,
+  float                     analogueOffset,
+  PS6000_BANDWIDTH_LIMITER  bandwidth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetTimebase)
+(
+  int16_t          handle,
+  uint32_t  timebase,
+  uint32_t  noSamples,
+  int32_t          *timeIntervalNanoseconds,
+  int16_t          oversample,
+  uint32_t *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetTimebase2)
+(
+  int16_t          handle,
+  uint32_t  timebase,
+  uint32_t  noSamples,
+  float         *timeIntervalNanoseconds,
+  int16_t          oversample,
+  uint32_t *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetSigGenArbitrary)
+(
+  int16_t                      handle,
+  int32_t                       offsetVoltage,
+  uint32_t              pkToPk,
+  uint32_t              startDeltaPhase,
+  uint32_t              stopDeltaPhase,
+  uint32_t              deltaPhaseIncrement,
+  uint32_t              dwellCount,
+  int16_t                     *arbitraryWaveform,
+  int32_t                       arbitraryWaveformSize,
+  PS6000_SWEEP_TYPE          sweepType,
+  PS6000_EXTRA_OPERATIONS    operation,
+  PS6000_INDEX_MODE          indexMode,
+  uint32_t              shots,
+  uint32_t              sweeps,
+  PS6000_SIGGEN_TRIG_TYPE    triggerType,
+  PS6000_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                      extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SetSigGenBuiltIn)
+(
+  int16_t                      handle,
+  int32_t                       offsetVoltage,
+  uint32_t              pkToPk,
+  int16_t                      waveType,
+  float                      startFrequency,
+  float                      stopFrequency,
+  float                      increment,
+  float                      dwellTime,
+  PS6000_SWEEP_TYPE          sweepType,
+  PS6000_EXTRA_OPERATIONS    operation,
+  uint32_t              shots,
+  uint32_t              sweeps,
+  PS6000_SIGGEN_TRIG_TYPE    triggerType,
+  PS6000_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                      extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SetSigGenBuiltInV2)
+(
+	int16_t										handle,
+	int32_t										offsetVoltage,
+	uint32_t									pkToPk,
+	int16_t 									waveType,
+	double 										startFrequency,
+	double										stopFrequency,
+	double 										increment,
+	double 										dwellTime,
+	PS6000_SWEEP_TYPE					sweepType,
+	PS6000_EXTRA_OPERATIONS		operation,
+	uint32_t									shots,
+	uint32_t									sweeps,
+	PS6000_SIGGEN_TRIG_TYPE		triggerType,
+	PS6000_SIGGEN_TRIG_SOURCE triggerSource,
+	int16_t										extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetSigGenPropertiesArbitrary)
+(
+  int16_t                      handle,
+  int32_t                       offsetVoltage,
+  uint32_t              pkToPk,
+  uint32_t              startDeltaPhase,
+  uint32_t              stopDeltaPhase,
+  uint32_t              deltaPhaseIncrement,
+  uint32_t              dwellCount,
+  PS6000_SWEEP_TYPE          sweepType,
+  uint32_t              shots,
+  uint32_t              sweeps,
+  PS6000_SIGGEN_TRIG_TYPE    triggerType,
+  PS6000_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                      extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SetSigGenPropertiesBuiltIn)
+(
+  int16_t                      handle,
+  int32_t                       offsetVoltage,
+  uint32_t              pkToPk,
+  double                      startFrequency,
+  double                      stopFrequency,
+  double                      increment,
+  double                      dwellTime,
+  PS6000_SWEEP_TYPE          sweepType,
+  uint32_t              shots,
+  uint32_t              sweeps,
+  PS6000_SIGGEN_TRIG_TYPE    triggerType,
+  PS6000_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                      extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	PS6000_INDEX_MODE							indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t  * minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SigGenSoftwareControl)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetSimpleTrigger)
+(
+  int16_t                       handle,
+  int16_t                       enable,
+  PS6000_CHANNEL              source,
+  int16_t                       threshold,
+  PS6000_THRESHOLD_DIRECTION  direction,
+  uint32_t               delay,
+  int16_t                       autoTrigger_ms
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetEts)
+(
+  int16_t            handle,
+  PS6000_ETS_MODE  mode,
+  int16_t            etsCycles,
+  int16_t            etsInterleave,
+  int32_t            *sampleTimePicoseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetTriggerChannelProperties)
+(
+  int16_t                              handle,
+  PS6000_TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                              nChannelProperties,
+  int16_t                              auxOutputEnable,
+  int32_t                               autoTriggerMilliseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetTriggerChannelConditions)
+(
+  int16_t                      handle,
+  PS6000_TRIGGER_CONDITIONS *conditions,
+  int16_t                      nConditions
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetTriggerChannelDirections)
+(
+  int16_t                       handle,
+  PS6000_THRESHOLD_DIRECTION  channelA,
+  PS6000_THRESHOLD_DIRECTION  channelB,
+  PS6000_THRESHOLD_DIRECTION  channelC,
+  PS6000_THRESHOLD_DIRECTION  channelD,
+  PS6000_THRESHOLD_DIRECTION  ext,
+  PS6000_THRESHOLD_DIRECTION  aux
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetTriggerDelay)
+(
+  int16_t          handle,
+  uint32_t  delay
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetPulseWidthQualifier)
+(
+  int16_t                       handle,
+  PS6000_PWQ_CONDITIONS      *conditions,
+  int16_t                       nConditions,
+  PS6000_THRESHOLD_DIRECTION  direction,
+  uint32_t               lower,
+  uint32_t               upper,
+  PS6000_PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000IsTriggerOrPulseWidthQualifierEnabled)
+(
+  int16_t  handle,
+  int16_t *triggerEnabled,
+  int16_t *pulseWidthQualifierEnabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetTriggerTimeOffset)
+(
+  int16_t              handle,
+  uint32_t     *timeUpper,
+  uint32_t     *timeLower,
+  PS6000_TIME_UNITS *timeUnits,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetTriggerTimeOffset64)
+(
+  int16_t              handle,
+  int64_t           *time,
+  PS6000_TIME_UNITS *timeUnits,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesTriggerTimeOffsetBulk)
+(
+  int16_t              handle,
+  uint32_t     *timesUpper,
+  uint32_t     *timesLower,
+  PS6000_TIME_UNITS *timeUnits,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesTriggerTimeOffsetBulk64)
+(
+  int16_t              handle,
+  int64_t           *times,
+  PS6000_TIME_UNITS *timeUnits,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetDataBuffers)
+(
+  int16_t             handle,
+  PS6000_CHANNEL    channel,
+  int16_t            *bufferMax,
+  int16_t            *bufferMin,
+  uint32_t     bufferLth,
+  PS6000_RATIO_MODE downSampleRatioMode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetDataBuffer)
+(
+  int16_t              handle,
+  PS6000_CHANNEL     channel,
+  int16_t             *buffer,
+  uint32_t      bufferLth,
+  PS6000_RATIO_MODE  downSampleRatioMode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetDataBufferBulk)
+(
+  int16_t              handle,
+  PS6000_CHANNEL     channel,
+  int16_t             *buffer,
+  uint32_t      bufferLth,
+  uint32_t      waveform,
+  PS6000_RATIO_MODE  downSampleRatioMode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetDataBuffersBulk)
+(
+  int16_t              handle,
+  PS6000_CHANNEL     channel,
+  int16_t             *bufferMax,
+  int16_t             *bufferMin,
+  uint32_t      bufferLth,
+  uint32_t      waveform,
+  PS6000_RATIO_MODE  downSampleRatioMode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetEtsTimeBuffer)
+(
+  int16_t          handle,
+  int64_t       *buffer,
+  uint32_t  bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetEtsTimeBuffers)
+(
+  int16_t          handle,
+  uint32_t *timeUpper,
+  uint32_t *timeLower,
+  uint32_t  bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000RunBlock)
+(
+  int16_t             handle,
+  uint32_t     noOfPreTriggerSamples,
+  uint32_t     noOfPostTriggerSamples,
+  uint32_t     timebase,
+  int16_t             oversample,
+  int32_t             *timeIndisposedMs,
+  uint32_t     segmentIndex,
+  ps6000BlockReady  lpReady,
+  void             *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000IsReady)
+(
+  int16_t  handle,
+  int16_t *ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000RunStreaming)
+(
+  int16_t              handle,
+  uint32_t     *sampleInterval,
+  PS6000_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t      maxPreTriggerSamples,
+  uint32_t      maxPostPreTriggerSamples,
+  int16_t              autoStop,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetStreamingLatestValues)
+(
+  int16_t                 handle,
+  ps6000StreamingReady  lpPs6000Ready,
+  void                 *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000NoOfStreamingValues)
+(
+  int16_t          handle,
+  uint32_t *noOfValues
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetMaxDownSampleRatio)
+(
+  int16_t              handle,
+  uint32_t      noOfUnaggreatedSamples,
+  uint32_t     *maxDownSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValues)
+(
+  int16_t              handle,
+  uint32_t      startIndex,
+  uint32_t     *noOfSamples,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex,
+  int16_t             *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesBulk)
+(
+  int16_t              handle,
+  uint32_t     *noOfSamples,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  int16_t             *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesAsync)
+(
+  int16_t              handle,
+  uint32_t      startIndex,
+  uint32_t      noOfSamples,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex,
+  void              *lpDataReady,
+  void              *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesOverlapped)
+(
+  int16_t              handle,
+  uint32_t      startIndex,
+  uint32_t     *noOfSamples,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex,
+  int16_t             *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesOverlappedBulk)
+(
+  int16_t              handle,
+  uint32_t      startIndex,
+  uint32_t     *noOfSamples,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex,
+  int16_t             *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesBulkAsyc)
+(
+  int16_t              handle,
+  uint32_t      startIndex,
+  uint32_t     *noOfSamples,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex,
+  int16_t             *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetNoOfCaptures)
+(
+  int16_t          handle,
+  uint32_t *nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetNoOfProcessedCaptures)
+(
+  int16_t          handle,
+  uint32_t *nProcessedCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000Stop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetNoOfCaptures)
+(
+  int16_t          handle,
+  uint32_t  nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetWaveformLimiter)
+(
+  int16_t          handle,
+  uint32_t  nWaveformsPerSecond
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000GetTriggerInfoBulk)
+(
+	int16_t										handle,
+	PS6000_TRIGGER_INFO			*	triggerInfo,
+	uint32_t									fromSegmentIndex,
+	uint32_t									toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000EnumerateUnits)
+(
+  int16_t *count,
+  int8_t  *serials,
+  int16_t *serialLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetExternalClock)
+(
+  int16_t                      handle,
+  PS6000_EXTERNAL_FREQUENCY  frequency,
+  int16_t                      threshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000PingUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetAnalogueOffset)
+(
+  int16_t            handle,
+  PS6000_RANGE     range,
+  PS6000_COUPLING  coupling,
+  float           *maximumVoltage,
+  float           *minimumVoltage
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000QueryTemperatures)
+(
+	int16_t					handle,
+	PS6000_TEMPERATURES * types,
+	float * temperatures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000QueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+);
+#endif

+ 765 - 0
pico-tcp-service/pico-tcp-client/inc/ps6000aApi.h

@@ -0,0 +1,765 @@
+/****************************************************************************
+ *
+ * Filename:    ps6000aApi.h
+ * Copyright:   Pico Technology Limited 2002 - 2022
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 6000 range of PC Oscilloscopes.
+ *
+ ****************************************************************************/
+#ifndef __PS6000AAPI_H__
+#define __PS6000AAPI_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+#include "PicoDeviceEnums.h"
+#include "PicoDeviceStructs.h"
+#include "PicoCallback.h"
+#include "PicoVersion.h"
+
+#ifdef __cplusplus
+#define PREF0 extern "C"
+#define TYPE_ENUM
+#else
+#define PREF0
+#define TYPE_ENUM enum
+#endif
+
+
+#ifdef WIN32
+	#ifdef PREF1
+		#undef PREF1
+	#endif
+	#ifdef PREF2
+		#undef PREF2
+	#endif
+	#ifdef PREF3
+		#undef PREF3
+	#endif
+	 //If you are dynamically linking PS6000A.DLL into your project #define DYNLINK here>
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (__stdcall *x)
+	#else
+		#define PREF1
+	#ifdef _USRDLL
+		#define PREF2 __declspec(dllexport) __stdcall
+	#else
+		#define PREF2 __declspec(dllimport) __stdcall
+	#endif
+		#define PREF3(x) x
+	#endif
+	#define PREF4 __stdcall
+#else
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+#define PREF4
+#endif
+
+typedef void (PREF4 *ps6000aBlockReady)
+(
+	int16_t				handle,
+	PICO_STATUS		status,
+	PICO_POINTER	pParameter
+	);
+
+typedef void (PREF4 *ps6000aDataReady)
+(
+	int16_t    					handle,
+	PICO_STATUS					status,
+	uint64_t     				noOfSamples,
+	int16_t    					overflow,
+	PICO_POINTER				pParameter
+	);
+
+typedef void (PREF4 *ps6000aProbeInteractions)
+(
+	int16_t    											handle,
+	PICO_STATUS											status,
+	PICO_USER_PROBE_INTERACTIONS *	probes,
+	uint32_t												nProbes
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000aOpenUnit)
+(
+	int16_t										*	handle,
+	int8_t										*	serial,
+	PICO_DEVICE_RESOLUTION		resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000aOpenUnitAsync)
+(
+	int16_t										*	status,
+	int8_t										*	serial,
+	PICO_DEVICE_RESOLUTION		resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000aOpenUnitProgress)
+(
+	int16_t *	handle,
+	int16_t *	progressPercent,
+	int16_t *	complete
+);
+
+// This function retrieves information about the specified oscilloscope or driver software.
+// If the device fails to open or no device is opened, it is still possible to read the driver version.
+//
+// parameters:
+// handle: identifies the device from which information is required. If an invalid handle is passed, only the driver versions can be read.
+// string: on exit, the unit information string selected specified by the info argument. If string is NULL, only requiredSize is returned.
+// stringLength: the maximum number of 8-bit integers (int8_t) that may be written to string.
+// requiredSize: on exit, the required length of the string array.
+// info: a number specifying what information is required.
+//
+// return:
+// PICO_OK
+// PICO_INVALID_HANDLE
+// PICO_NULL_PARAMETER
+// PICO_INVALID_INFO
+// PICO_INFO_UNAVAILABLE
+// PICO_DRIVER_FUNCTION
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetUnitInfo)
+(
+	int16_t				handle,
+	int8_t			*	string,
+	int16_t				stringLength,
+	int16_t     *	requiredSize,
+	PICO_INFO			info
+);
+
+// This function retrieves information about the accessory (probe, or MSO Pod) attached to the specified channel.
+// Note: you must set a probe interaction callback to be able to retrieve probe information.
+//
+// parameters:
+// handle: identifies the device to which the accessory is attached.
+// channel: identifies the channel to which the accessory is attached. If no accessory is connected to this channel, an error will result.
+// string: on exit, the accessory information string selected specified by the info argument. If string is NULL, only requiredSize is returned.
+// stringLength: the maximum number of 8-bit integers (int8_t) that may be written to string.
+// requiredSize: on exit, the required length of the string array.
+// info: a number specifying what information is required. Note that unlike ps6000aGetUnitInfo, only PICO_BATCH_AND_SERIAL and PICO_CAL_DATE are valid for accessories.
+//
+// return:
+// PICO_OK
+// PICO_INVALID_HANDLE (handle isn't that of an open PicoScope device.)
+// PICO_PROBE_COLLECTION_NOT_STARTED (handle hasn't got a probe interaction callback set).
+// PICO_INVALID_CHANNEL (channel doesn't map to a channel on the device with handle.)
+// PICO_NULL_PARAMETER (requiredSize is NULL.)
+// PICO_INVALID_INFO (info is an invalid value for the attached accessory.)
+// PICO_NOT_SUPPORTED_BY_THIS_DEVICE (no accessory is connected, or the connected accessory does not support any info.)
+// PICO_DRIVER_FUNCTION (another thread is already calling a driver function.)
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetAccessoryInfo)
+(
+	int16_t				handle,
+	PICO_CHANNEL	channel,
+	int8_t			* string,
+	int16_t				stringLength,
+	int16_t			* requiredSize,
+	PICO_INFO			info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000aCloseUnit)
+(
+	int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aFlashLed)
+(
+	int16_t handle,
+	int16_t start
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aMemorySegments)
+(
+	int16_t     handle,
+	uint64_t		nSegments,
+	uint64_t *	nMaxSamples
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aMemorySegmentsBySamples)
+(
+	int16_t			handle,
+	uint64_t 		nSamples,
+	uint64_t	* nMaxSegments
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetMaximumAvailableMemory)
+(
+	int16_t     handle,
+	uint64_t *	nMaxSamples,
+	PICO_DEVICE_RESOLUTION resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aQueryMaxSegmentsBySamples)
+(
+	int16_t handle,
+	uint64_t nSamples,
+	uint32_t nChannelEnabled,
+	uint64_t * nMaxSegments,
+	PICO_DEVICE_RESOLUTION resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetChannelOn)
+(
+	int16_t                       handle,
+	PICO_CHANNEL                  channel,
+	PICO_COUPLING                 coupling,
+	PICO_CONNECT_PROBE_RANGE      range,
+	double                        analogueOffset,
+	PICO_BANDWIDTH_LIMITER        bandwidth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetChannelOff)
+(
+  int16_t                       handle,
+  PICO_CHANNEL                  channel
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDigitalPortOn)
+(
+	int16_t					              handle,
+	PICO_CHANNEL		              port,
+	int16_t *				              logicThresholdLevel,
+	int16_t					              logicThresholdLevelLength,
+	PICO_DIGITAL_PORT_HYSTERESIS  hysteresis
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDigitalPortOff)
+(
+  int16_t					              handle,
+  PICO_CHANNEL		              port
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetTimebase)
+(
+	int16_t         handle,
+	uint32_t				timebase,
+	uint64_t				noSamples,
+	double        *	timeIntervalNanoseconds,
+	uint64_t			*	maxSamples,
+	uint64_t			  segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenWaveform)
+(
+	int16_t						handle,
+	PICO_WAVE_TYPE		waveType,
+	int16_t					* buffer,
+	uint64_t					bufferLength
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenRange)
+(
+	int16_t         handle,
+	double          peakToPeakVolts,
+	double          offsetVolts
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenWaveformDutyCycle)
+(
+	int16_t					handle,
+	double				  dutyCyclePercent
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenTrigger)
+(
+	int16_t											handle,
+	PICO_SIGGEN_TRIG_TYPE				triggerType,
+	PICO_SIGGEN_TRIG_SOURCE			triggerSource,
+	uint64_t										cycles,
+	uint64_t                    autoTriggerPicoSeconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenFilter)
+(
+	int16_t											handle,
+	PICO_SIGGEN_FILTER_STATE		filterState
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenFrequency)
+(
+	int16_t							handle,
+	double							frequencyHz
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenFrequencySweep)
+(
+	int16_t							handle,
+	double						  stopFrequencyHz,
+	double							frequencyIncrement,
+	double							dwellTimeSeconds,
+	PICO_SWEEP_TYPE			sweepType
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenPhase)
+(
+	int16_t							handle,
+	uint64_t						deltaPhase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenPhaseSweep)
+(
+	int16_t							handle,
+	uint64_t						stopDeltaPhase,
+	uint64_t						deltaPhaseIncrement,
+	uint64_t						dwellCount,
+	PICO_SWEEP_TYPE			sweepType
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenClockManual)
+(
+	int16_t							handle,
+	double							dacClockFrequency,
+	uint64_t						prescaleRatio
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenSoftwareTriggerControl)
+(
+	int16_t										handle,
+	PICO_SIGGEN_TRIG_TYPE			triggerState
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenApply)
+(
+	int16_t							handle,
+	int16_t             sigGenEnabled,
+	int16_t             sweepEnabled,
+	int16_t             triggerEnabled,
+	int16_t							automaticClockOptimisationEnabled,
+  int16_t             overrideAutomaticClockAndPrescale,
+	double						* frequency,
+	double						* stopFrequency,
+	double						* frequencyIncrement,
+	double						* dwellTime
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenLimits)
+(
+	int16_t							     handle,
+	PICO_SIGGEN_PARAMETER    parameter,
+	double                 * minimumPermissibleValue,
+	double                 * maximumPermissibleValue,
+	double                 * step
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenFrequencyLimits)
+(
+	int16_t							     handle,
+  PICO_WAVE_TYPE           waveType,
+  uint64_t               * numSamples,
+  double                 * startFrequency,
+  int16_t                  sweepEnabled,
+  double                 * manualDacClockFrequency,
+  uint64_t               * manualPrescaleRatio,
+  double                 * maxStopFrequencyOut,
+  double                 * minFrequencyStepOut,
+  double                 * maxFrequencyStepOut,
+  double                 * minDwellTimeOut,
+  double                 * maxDwellTimeOut
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenPause)
+(
+	int16_t										handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenRestart)
+(
+	int16_t										handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetSimpleTrigger)
+(
+	int16_t                   handle,
+	int16_t                   enable,
+	PICO_CHANNEL              source,
+	int16_t                   threshold,
+	PICO_THRESHOLD_DIRECTION  direction,
+	uint64_t									delay,
+	uint32_t                  autoTriggerMicroSeconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aTriggerWithinPreTriggerSamples)
+(
+  int16_t handle,
+  PICO_TRIGGER_WITHIN_PRE_TRIGGER state
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTriggerChannelProperties)
+(
+	int16_t                           handle,
+	PICO_TRIGGER_CHANNEL_PROPERTIES *	channelProperties,
+	int16_t                           nChannelProperties,
+	int16_t                           auxOutputEnable,
+	uint32_t                          autoTriggerMicroSeconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTriggerChannelConditions)
+(
+	int16_t						handle,
+	PICO_CONDITION	*	conditions,
+	int16_t						nConditions,
+	PICO_ACTION				action
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTriggerChannelDirections)
+(
+	int16_t											handle,
+	PICO_DIRECTION					*		directions,
+	int16_t											nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTriggerDelay)
+(
+	int16_t   handle,
+	uint64_t  delay
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetPulseWidthQualifierProperties)
+(
+	int16_t											handle,
+	uint32_t										lower,
+	uint32_t										upper,
+	PICO_PULSE_WIDTH_TYPE				type
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetPulseWidthQualifierConditions)
+(
+	int16_t						handle,
+	PICO_CONDITION	*	conditions,
+	int16_t						nConditions,
+	PICO_ACTION				action
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetPulseWidthQualifierDirections)
+(
+	int16_t											handle,
+	PICO_DIRECTION					*		directions,
+	int16_t											nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTriggerDigitalPortProperties)
+(
+  int16_t handle,
+  PICO_CHANNEL port,
+  PICO_DIGITAL_CHANNEL_DIRECTIONS * directions,
+  int16_t														nDirections
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetPulseWidthDigitalPortProperties)
+(
+  int16_t handle,
+  PICO_CHANNEL port,
+  PICO_DIGITAL_CHANNEL_DIRECTIONS* directions,
+  int16_t														nDirections
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetTriggerTimeOffset)
+(
+	int16_t           handle,
+	int64_t         *	time,
+	PICO_TIME_UNITS *	timeUnits,
+	uint64_t					segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValuesTriggerTimeOffsetBulk)
+(
+	int16_t             handle,
+	int64_t           *	times,
+	PICO_TIME_UNITS		*	timeUnits,
+	uint64_t						fromSegmentIndex,
+	uint64_t						toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDataBuffer)
+(
+	int16_t								handle,
+	PICO_CHANNEL					channel,
+	PICO_POINTER					buffer,
+	int32_t								nSamples,
+	PICO_DATA_TYPE				dataType,
+	uint64_t							waveform,
+	PICO_RATIO_MODE				downSampleRatioMode,
+	PICO_ACTION						action
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDataBuffers)
+(
+	int16_t           handle,
+	PICO_CHANNEL			channel,
+	PICO_POINTER			bufferMax,
+	PICO_POINTER			bufferMin,
+	int32_t						nSamples,
+	PICO_DATA_TYPE		dataType,
+	uint64_t					waveform,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	PICO_ACTION				action
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aRunBlock)
+(
+	int16_t							handle,
+	uint64_t						noOfPreTriggerSamples,
+	uint64_t						noOfPostTriggerSamples,
+	uint32_t						timebase,
+	double           *	timeIndisposedMs,
+	uint64_t						segmentIndex,
+	ps6000aBlockReady		lpReady,
+	PICO_POINTER				pParameter
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aIsReady)
+(
+	int16_t   handle,
+	int16_t * ready
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aRunStreaming)
+(
+	int16_t           handle,
+	double				*	sampleInterval,
+	PICO_TIME_UNITS		sampleIntervalTimeUnits,
+	uint64_t					maxPreTriggerSamples,
+	uint64_t					maxPostPreTriggerSamples,
+	int16_t           autoStop,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetStreamingLatestValues)
+(
+	int16_t															handle,
+	PICO_STREAMING_DATA_INFO					*	streamingDataInfo,
+	uint64_t														nStreamingDataInfos,
+	PICO_STREAMING_DATA_TRIGGER_INFO	* triggerInfo
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aNoOfStreamingValues)
+(
+	int16_t     handle,
+	uint64_t *	noOfValues
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValues)
+(
+	int16_t           handle,
+	uint64_t					startIndex,
+	uint64_t				*	noOfSamples,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	uint64_t					segmentIndex,
+	int16_t         *	overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValuesBulk)
+(
+	int16_t           handle,
+	uint64_t					startIndex,
+	uint64_t				*	noOfSamples,
+	uint64_t					fromSegmentIndex,
+	uint64_t					toSegmentIndex,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	int16_t         *	overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValuesAsync)
+(
+	int16_t           handle,
+	uint64_t					startIndex,
+	uint64_t					noOfSamples,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	uint64_t					segmentIndex,
+	PICO_POINTER			lpDataReady,
+	PICO_POINTER			pParameter
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValuesBulkAsync)
+(
+	int16_t           handle,
+	uint64_t					startIndex,
+	uint64_t					noOfSamples,
+	uint64_t					fromSegmentIndex,
+	uint64_t					toSegmentIndex,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	PICO_POINTER			lpDataReady,
+	PICO_POINTER			pParameter
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValuesOverlapped)
+(
+	int16_t           handle,
+	uint64_t					startIndex,
+	uint64_t				*	noOfSamples,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	uint64_t					fromSegmentIndex,
+	uint64_t					toSegmentIndex,
+	int16_t         *	overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aStopUsingGetValuesOverlapped)
+(
+  int16_t           handle
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetNoOfCaptures)
+(
+	int16_t     handle,
+	uint64_t *	nCaptures
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetNoOfProcessedCaptures)
+(
+	int16_t     handle,
+	uint64_t *	nProcessedCaptures
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aStop)
+(
+	int16_t  handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetNoOfCaptures)
+(
+	int16_t   handle,
+	uint64_t  nCaptures
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetTriggerInfo)
+(
+	int16_t									handle,
+	PICO_TRIGGER_INFO			*	triggerInfo,
+	uint64_t								firstSegmentIndex,
+	uint64_t								segmentCount
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aEnumerateUnits)
+(
+	int16_t *	count,
+	int8_t  *	serials,
+	int16_t *	serialLth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aPingUnit)
+(
+	int16_t  handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetAnalogueOffsetLimits)
+(
+  int16_t                     handle,
+  PICO_CONNECT_PROBE_RANGE    range,
+  PICO_COUPLING               coupling,
+  double                      * maximumVoltage,
+  double                      * minimumVoltage
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetMinimumTimebaseStateless)
+(
+	int16_t                     handle,
+  PICO_CHANNEL_FLAGS          enabledChannelFlags,
+	uint32_t                    * timebase,
+	double                      * timeInterval,
+	PICO_DEVICE_RESOLUTION      resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aNearestSampleIntervalStateless)
+(
+	int16_t                 handle,
+  PICO_CHANNEL_FLAGS      enabledChannelFlags,
+	double		              timeIntervalRequested,
+	PICO_DEVICE_RESOLUTION  resolution,
+	uint32_t	            * timebase,
+	double		            * timeIntervalAvailable
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aChannelCombinationsStateless)
+(
+	int16_t   handle,
+	PICO_CHANNEL_FLAGS * channelFlagsCombinations,
+	uint32_t * nChannelCombinations,
+	PICO_DEVICE_RESOLUTION resolution,
+	uint32_t timebase
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDeviceResolution)
+(
+	int16_t  handle,
+	PICO_DEVICE_RESOLUTION resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetDeviceResolution)
+(
+	int16_t  handle,
+	PICO_DEVICE_RESOLUTION * resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetScalingValues)
+(
+	int16_t	handle,
+	PICO_SCALING_FACTORS_VALUES *scalingValues,
+	int16_t nChannels
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetAdcLimits)
+(
+	int16_t   handle,
+	PICO_DEVICE_RESOLUTION resolution,
+	int16_t * minValue,
+	int16_t * maxValue
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aCheckForUpdate)
+(
+	int16_t	handle,
+	PICO_FIRMWARE_INFO* firmwareInfos,
+	int16_t* nFirmwareInfos,
+	uint16_t* updatesRequired
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aStartFirmwareUpdate)
+(
+	int16_t	handle,
+	PicoUpdateFirmwareProgress progress
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aResetChannelsAndReportAllChannelsOvervoltageTripStatus)(
+  int16_t handle,
+  PICO_CHANNEL_OVERVOLTAGE_TRIPPED* allChannelsTrippedStatus,
+  uint8_t nChannelTrippedStatus);
+
+PREF0 PREF1 PICO_STATUS PREF2
+  PREF3(ps6000aReportAllChannelsOvervoltageTripStatus)(int16_t handle,
+                                                       PICO_CHANNEL_OVERVOLTAGE_TRIPPED* allChannelsTrippedStatus,
+                                                       uint8_t nChannelTrippedStatus);
+
+#endif

+ 116 - 0
pico-tcp-service/pico-tcp-client/inc/ps6000aApiExperimental.h

@@ -0,0 +1,116 @@
+/****************************************************************************
+ *
+ * Filename:    ps6000aApiExperimental.h
+ * Copyright:   Pico Technology Limited 2002 - 2022
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 6000 range of PC Oscilloscopes.
+ *
+ * These functions are at the beta stage of development and their
+ * signatures may change.
+ *
+ ****************************************************************************/
+
+#ifndef __PS6000AAPIEXPERIMENTAL_H__
+#define __PS6000AAPIEXPERIMENTAL_H__
+
+
+#include "ps6000aApi.h"
+#include "PicoCallback.h"
+#include "PicoDeviceDefinitionsExperimental.h"
+
+#include <stdint.h>
+
+typedef void (PREF4 *ps6000aDigitalPortInteractions)
+(
+  int16_t    											handle,
+  PICO_STATUS											status,
+  PICO_DIGITAL_PORT_INTERACTIONS *	ports,
+  uint32_t												nPorts
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDigitalPortInteractionCallback)
+(
+  int16_t													handle,
+  ps6000aDigitalPortInteractions	callback
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetProbeInteractionCallback)
+(
+  int16_t		handle,
+  PicoProbeInteractions callback
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetExternalReferenceInteractionCallback)
+(
+  int16_t		handle,
+  PicoExternalReferenceInteractions callback
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetAWGOverrangeInteractionCallback)
+(
+  int16_t		handle,
+  PicoAWGOverrangeInteractions callback
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTemperatureSensorInteractionCallback)
+(
+  int16_t		handle,
+  PicoTemperatureSensorInteractions callback
+  );
+
+/// <summary>
+/// Callback signature for a probe user action notification (not to be confused with
+/// the connection / fault status change which is notified via PicoProbeInteractions).
+/// </summary>
+/// <param name="handle">The handle to the device to which the probe is attached.</param>
+/// <param name="status">
+/// Indicates if anything went wrong while handling the probe event
+/// (e.g. probe signaled an interrupt, but then communication with the probe failed).</param>
+/// <param name="channel">The channel to which the probe was attached that signaled
+/// the interrupt.
+/// </param>
+/// <param name="probe">The type of probe connected to the channel.</param>
+/// <param name="action">The probe action which the user performed.</param>
+/// <param name="pActionParameter">
+/// A pointer to a struct containing the parameters for
+/// the action, (e.g. in case of PICO_PROBE_BUTTON_PRESS, this is a
+/// PICO_PROBE_BUTTON_PRESS_PARAMETER *).
+/// </param>
+/// <param name="pParameter">A pointer to the user parameter given when setting the callback.</param>
+typedef void(PREF5* PicoProbeUserAction)(int16_t handle,
+                                         PICO_STATUS status,
+                                         PICO_CHANNEL channel,
+                                         PICO_CONNECT_PROBE probe,
+                                         PICO_PROBE_USER_ACTION action,
+                                         PICO_POINTER pActionParameter,
+                                         PICO_POINTER pParameter);
+
+/// <summary>
+/// Sets a callback for probe-specific user actions (such as button-press events).
+/// Note that ps6000aSetProbeInteractionCallback must have already been called before calling this
+/// function. Also note that like all other user callbacks (probe arrival / status, MSO arrival,
+/// temperature, external reference, AWG overrange), this callback will occur on the user interaction
+/// event loop, so it is guaranteed not to be invoked concurrently with any others. The parameter
+/// pointer will be passed back to the user via the last argument on the callback on subsequent
+/// invocations.
+/// </summary>
+/// <param name="handle">The handle to the device to which the probe is attached.</param>
+/// <param name="callback">A pointer to the callback function.</param>
+/// <param name="pParameter">A pointer to the user data.</param>
+/// <returns>
+/// A status indicating whether the callback was configured successfully. Possible errors:
+///   PICO_INVALID_HANDLE - the given handle is unknown to the driver or has been closed
+///   PICO_DRIVER_FUNCTION - a driver function has been called on another thread
+///   PICO_NOT_SUPPORTED_BY_THIS_DEVICE - the device associated with this handle does not support
+///     intelligent probes
+///   PICO_PROBE_COLLECTION_NOT_STARTED - no probe interaction callback is currently set
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetProbeUserActionCallback) (
+  int16_t handle,
+  PicoProbeUserAction callback,
+  PICO_POINTER pParameter
+  );
+
+#endif

+ 364 - 0
pico-tcp-service/pico-tcp-client/inc/usbDrDaqApi.h

@@ -0,0 +1,364 @@
+/**************************************************************************
+*
+* Filename:    usbDrDaqApi.h
+* Author:      RPM & MAS
+* Description:
+*
+* This header defines the interface to driver routines for the
+* USB DrDAQ Data Logger.
+*
+* Copyright © 2010-2018 Pico Technology Ltd. All rights reserved.
+*
+*************************************************************************/
+#ifndef __USBDRDAQAPI_H__
+#define  __USBDRDAQAPI_H__
+
+#include <stdint.h>
+
+#define USB_DRDAQ_MAX_AWG_VALUE 1000
+
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+//	If you are dynamically linking usbdrdaq.dll into your project #define DYNLINK
+//  somewhere in your project before here.
+#ifdef WIN32
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (__stdcall *x)
+	#else
+		#define PREF1
+		#ifdef _USRDLL
+			#define PREF2 __declspec(dllexport) __stdcall
+		#else
+			#define PREF2 __declspec(dllimport) __stdcall
+		#endif
+		#define PREF3(x) x
+	#endif
+#else
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+	#define __stdcall
+#endif
+
+typedef enum enUsbDrDaqInputs
+{
+ 	USB_DRDAQ_CHANNEL_EXT1 = 1,				//Ext. sensor 1
+  USB_DRDAQ_CHANNEL_EXT2,						//Ext. sensor 2
+  USB_DRDAQ_CHANNEL_EXT3,						//Ext. sensor 3
+	USB_DRDAQ_CHANNEL_SCOPE,					//Scope channel
+  USB_DRDAQ_CHANNEL_PH,							//PH
+	USB_DRDAQ_CHANNEL_RES,						//Resistance
+  USB_DRDAQ_CHANNEL_LIGHT,					//Light
+	USB_DRDAQ_CHANNEL_TEMP,						//Thermistor
+  USB_DRDAQ_CHANNEL_MIC_WAVE,				//Microphone waveform
+	USB_DRDAQ_CHANNEL_MIC_LEVEL,			//Microphone level
+	USB_DRDAQ_MAX_CHANNELS = USB_DRDAQ_CHANNEL_MIC_LEVEL
+} USB_DRDAQ_INPUTS;
+
+typedef enum enUsbDrDaqScopeRange
+{
+	USB_DRDAQ_1V25,
+	USB_DRDAQ_2V5,
+	USB_DRDAQ_5V,
+	USB_DRDAQ_10V
+}USB_DRDAQ_SCOPE_RANGE;
+
+typedef enum enUsbDrDaqWave
+{
+	USB_DRDAQ_SINE,
+	USB_DRDAQ_SQUARE,
+	USB_DRDAQ_TRIANGLE,
+	USB_DRDAQ_RAMP_UP,
+	USB_DRDAQ_RAMP_DOWN,
+	USB_DRDAQ_DC
+}USB_DRDAQ_WAVE;
+
+typedef enum enUsbDrDaqDO
+{
+	USB_DRDAQ_GPIO_1 = 1,
+	USB_DRDAQ_GPIO_2,
+	USB_DRDAQ_GPIO_3,
+	USB_DRDAQ_GPIO_4
+}USB_DRDAQ_GPIO;
+
+typedef enum enUSBDrDAQInfo
+{
+  USBDrDAQ_DRIVER_VERSION,
+  USBDrDAQ_USB_VERSION,
+  USBDrDAQ_HARDWARE_VERSION,
+  USBDrDAQ_VARIANT_INFO,
+  USBDrDAQ_BATCH_AND_SERIAL,
+  USBDrDAQ_CAL_DATE,	
+  USBDrDAQ_KERNEL_DRIVER_VERSION, 
+  USBDrDAQ_ERROR,
+  USBDrDAQ_SETTINGS,
+  USBDrDAQ_FIRMWARE_VERSION,
+  USBDrDAQ_DRIVER_PATH = 14
+} USBDrDAQ_INFO;
+											
+#ifndef BM_DEFINED
+#define BM_DEFINED
+typedef enum _BLOCK_METHOD{BM_SINGLE, BM_WINDOW, BM_STREAM} BLOCK_METHOD;
+#endif
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqOpenUnit)
+(
+	int16_t *handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqCloseUnit)
+(
+	int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetUnitInfo)
+(	
+	int16_t			handle,		
+	int8_t			*string, 
+	int16_t			stringLength, 
+	int16_t			*requiredSize, 
+	PICO_INFO info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqRun) 
+(
+	int16_t						handle, 
+	uint32_t		no_of_values, 
+	BLOCK_METHOD		method
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqReady)
+(
+	int16_t handle, 
+	int16_t *ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqStop) 
+(
+	int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetInterval)
+(	
+	int16_t							handle,
+	uint32_t			*us_for_block,
+	uint32_t			ideal_no_of_samples,
+	USB_DRDAQ_INPUTS	*channels,
+	int16_t							no_of_channels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetIntervalF)
+(	
+	int16_t							handle,
+	float						*	us_for_block,
+	uint32_t			ideal_no_of_samples,
+	USB_DRDAQ_INPUTS	*channels,
+	int16_t							no_of_channels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetTrigger)
+(
+	int16_t						handle,
+	uint16_t	enabled,
+	uint16_t	auto_trigger,
+	uint16_t	auto_ms,
+	uint16_t	channel,
+	uint16_t	dir,
+	int16_t						threshold,
+	uint16_t	hysterisis,
+	float						delay
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetValues) 
+(
+	int16_t						handle,
+	int16_t						*values,
+	uint32_t		*noOfValues, 
+	uint16_t	*overflow,
+	uint32_t		*triggerIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetValuesF) 
+	(
+	int16_t						handle,
+	float						*values,
+	uint32_t		*noOfValues, 
+	uint16_t	*overflow,
+	uint32_t		*triggerIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetTriggerTimeOffsetNs)	
+(
+	int16_t		handle, 
+	int64_t *time
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetSingle) 
+(
+	int16_t							handle, 
+	USB_DRDAQ_INPUTS	channel, 
+	int16_t							*value, 
+	uint16_t		*overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetSingleF) 
+	(
+	int16_t							handle, 
+	USB_DRDAQ_INPUTS	channel, 
+	float							*value, 
+	uint16_t		*overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqOpenUnitAsync) 
+(
+	int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqOpenUnitProgress) 
+(
+	int16_t *handle, 
+	int16_t *progress, 
+	int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetScalings)
+(
+	int16_t							handle, 
+	USB_DRDAQ_INPUTS	channel, 
+	int16_t							*nScales, 
+	int16_t							*currentScale, 
+	int8_t							*names, 
+	int16_t							namesSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetScalings)
+(
+	int16_t							handle, 
+	USB_DRDAQ_INPUTS	channel, 
+	int16_t							scalingNumber
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetSigGenBuiltIn)
+(
+	int16_t						handle, 
+	int32_t						offsetVoltage,
+	uint32_t		pkToPk,
+	int16_t						frequency,
+	USB_DRDAQ_WAVE	waveType
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetSigGenArbitrary)
+(
+	int16_t					handle, 
+	int32_t					offsetVoltage,
+	uint32_t	pkToPk,
+	int16_t					*arbitraryWaveform,
+	int16_t					arbitraryWaveformSize,
+	int32_t					updateRate
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqStopSigGen)
+(
+	int16_t	handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetDO)
+(
+	int16_t						handle,
+	USB_DRDAQ_GPIO	IOChannel,
+	int16_t						value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetPWM)
+(
+	int16_t						handle,
+	USB_DRDAQ_GPIO	IOChannel,
+	uint16_t	period,
+	uint8_t		cycle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetInput)
+(
+	int16_t						handle,
+	USB_DRDAQ_GPIO	IOChannel,
+	int16_t						pullUp,
+	int16_t						*value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqStartPulseCount)
+(
+	int16_t						handle,
+	USB_DRDAQ_GPIO	IOChannel,
+	int16_t						direction
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetPulseCount)
+(
+	int16_t						handle,
+	USB_DRDAQ_GPIO	IOChannel,
+	int16_t						*count
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqEnableRGBLED)
+(
+	int16_t	handle,
+	int16_t enabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetRGBLED)
+(
+	int16_t	handle,
+	uint16_t	red,
+	uint16_t	green,
+	uint16_t	blue
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetChannelInfo)
+(
+	int16_t							handle,
+	float							*min,
+	float							*max,
+	int16_t							*places,
+	int16_t 						*divider,
+	USB_DRDAQ_INPUTS	channel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbDrDaqPingUnit) (int16_t handle);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(UsbDrDaqPhTemperatureCompensation)
+(
+	int16_t	handle,
+	uint16_t enabled
+	);
+#endif

+ 181 - 0
pico-tcp-service/pico-tcp-client/inc/usbPT104Api.h

@@ -0,0 +1,181 @@
+/**************************************************************************
+*
+* Filename:    usbPT104Api.h
+* Author:      MAS
+* Description:
+*
+* This header defines the interface to driver routines for the
+* USB PT-104 Platinum Resistance Temperature Data Logger.
+*
+* Copyright � 2009 - 2022 Pico Technology Ltd. All rights reserved.
+*
+*************************************************************************/
+#ifndef __USBPT104API_H__
+#define __USBPT104API_H__
+
+#include <stdint.h>
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+  //	If you are dynamically linking usbpt104.DLL into your project #define DYNLINK
+  //  somewhere in your project before here.
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+#else
+  /* Define a 64-bit integer type */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+#endif
+
+#define USBPT104_MIN_WIRES 2
+#define USBPT104_MAX_WIRES 4
+
+typedef enum enUsbPt104Channels
+{
+  USBPT104_CHANNEL_1 = 1,
+  USBPT104_CHANNEL_2,
+  USBPT104_CHANNEL_3,
+  USBPT104_CHANNEL_4,
+  USBPT104_CHANNEL_5,
+  USBPT104_CHANNEL_6,
+  USBPT104_CHANNEL_7,
+  USBPT104_CHANNEL_8,
+	USBPT104_MAX_CHANNELS = USBPT104_CHANNEL_8
+} USBPT104_CHANNELS;
+
+
+typedef enum enUsbPt104DataType
+{
+  USBPT104_OFF,
+  USBPT104_PT100,
+  USBPT104_PT1000,
+  USBPT104_RESISTANCE_TO_375R,
+  USBPT104_RESISTANCE_TO_10K,
+  USBPT104_DIFFERENTIAL_TO_115MV,
+  USBPT104_DIFFERENTIAL_TO_2500MV,
+  USBPT104_SINGLE_ENDED_TO_115MV,
+  USBPT104_SINGLE_ENDED_TO_2500MV,
+  USBPT104_MAX_DATA_TYPES
+} USBPT104_DATA_TYPES;
+
+typedef enum enIpDetailsType
+{
+  IDT_GET,
+  IDT_SET,
+} IP_DETAILS_TYPE;
+
+typedef enum enCommunicationType
+{
+  CT_USB = 0x00000001,
+  CT_ETHERNET = 0x00000002,
+  CT_ALL = 0xFFFFFFFF
+}COMMUNICATION_TYPE;
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbPt104Enumerate)
+(
+  int8_t   *details,
+  uint32_t *length,
+  COMMUNICATION_TYPE type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104OpenUnit)
+(
+  int16_t *handle,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbPt104OpenUnitViaIp)
+(
+  int16_t *handle,
+  int8_t  *serial,
+  int8_t  *ipAddress
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104CloseUnit)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbPt104IpDetails)
+(
+  int16_t   handle,
+  int16_t  *enabled,
+  int8_t   *ipaddress,
+  uint16_t *length,
+  uint16_t *listeningPort,
+  IP_DETAILS_TYPE type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104GetUnitInfo)
+(
+  int16_t    handle,
+  int8_t    *string,
+  int16_t    stringLength,
+  int16_t   *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104SetChannel)
+(
+  int16_t              handle,
+  USBPT104_CHANNELS    channel,
+  USBPT104_DATA_TYPES  type,
+  int16_t              noOfWires
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104SetMains)
+(
+  int16_t  handle,
+  uint16_t sixtyHertz
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104GetValue)
+(
+  int16_t            handle,
+  USBPT104_CHANNELS  channel,
+  int32_t           *value,
+  int16_t            filtered
+);
+
+#endif

+ 387 - 0
pico-tcp-service/pico-tcp-client/inc/usbtc08.h

@@ -0,0 +1,387 @@
+/*********************************************************************
+ *
+ * Filename:    usbtc08.h
+ * Author:      SDI & MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ * USB TC-08 Thermocouple Data Loggers.
+ *
+ * History:	12May03 SDI Created
+ *
+ * Copyright � 2002 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ *********************************************************************/
+#ifndef __USBTC08_H__
+#define __USBTC08_H__
+
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+  #ifdef PREF1
+    #undef PREF1
+  #endif
+  #ifdef PREF2
+    #undef PREF2
+  #endif
+  #ifdef PREF3
+    #undef PREF3
+  #endif
+  /*	If you are dynamically linking usbtc08.dll into your project #define DYNLINK here
+  */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec (dllexport) __stdcall
+    #else
+      #define PREF2 __declspec (dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define __stdcall
+#endif
+
+
+/* General Defines **************************************************/
+#define USBTC08_MAX_FILTER_SIZE   255
+#define USBTC08_MAX_SAMPLE_BUFFER 600 /* Max readings that usb_tc08_get_temp will ever return */
+#define USBTC08_MAX_INFO_CHARS    256
+#define USBTC08_MAX_DATE_CHARS    9
+#define USBTC08_MAX_SERIAL_CHARS  11
+#define USBTC08_MAX_VERSION_CHARS 12
+#define USBTC08_MAX_VERSION_CHARS_V2 25
+
+/* Enumerations *****************************************************/
+
+/* There are 8 channels from 1 to 8
+ *  to enumerate them, use:
+ *
+ *  for (i = 1; i <= USBTC08_MAX_CHANNELS; i++)
+ *
+ *  the Cold Junction Compensation is channel 0
+ */
+typedef enum enUSBTC08Channels
+{
+  USBTC08_CHANNEL_CJC,
+  USBTC08_CHANNEL_1,
+  USBTC08_CHANNEL_2,
+  USBTC08_CHANNEL_3,
+  USBTC08_CHANNEL_4,
+  USBTC08_CHANNEL_5,
+  USBTC08_CHANNEL_6,
+  USBTC08_CHANNEL_7,
+  USBTC08_CHANNEL_8,
+  USBTC08_MAX_CHANNELS = USBTC08_CHANNEL_8
+} USBTC08_CHANNELS;
+
+typedef enum enUSBTC08Progress
+{
+  USBTC08_PROGRESS_FAIL     = -1,
+  USBTC08_PROGRESS_PENDING  = 0,
+  USBTC08_PROGRESS_COMPLETE = 1
+} USBTC08_PROGRESS;
+
+typedef enum enUSBTC08Error
+{
+  /*========================
+  User/Developer error codes
+  =========================*/
+  USBTC08_ERROR_OK,
+  USBTC08_ERROR_OS_NOT_SUPPORTED,	      /* need to use win98 (or later) or win2k (or later) */
+  USBTC08_ERROR_NO_CHANNELS_SET,
+  USBTC08_ERROR_INVALID_PARAMETER,      /* one or more of the function arguments was invalid */
+  USBTC08_ERROR_VARIANT_NOT_SUPPORTED,  /* the hardware version is not supported (download the latest driver) */
+  USBTC08_ERROR_INCORRECT_MODE,         /* an incompatible mix of legacy and non-legacy functions was called
+                                           ... or usb_tc08_get_single was called while streaming was active */
+  USBTC08_ERROR_ENUMERATION_INCOMPLETE, /* a second call to usb_tc08_open_unit_async() was made before
+                                           asynchronous enumeration had completed */
+
+  /*=======================
+  Reserved Pico error codes
+  ========================*/
+  USBTC08_ERROR_NOT_RESPONDING,         /* unit is not responding to the driver */
+  USBTC08_ERROR_FW_FAIL,                /* unabled to download firmware */
+  USBTC08_ERROR_CONFIG_FAIL,		        /* missing or corrupted eeprom */
+  USBTC08_ERROR_NOT_FOUND,			        /* cannot find enumerated device */
+  USBTC08_ERROR_THREAD_FAIL,            /* a threading function failed */
+  USBTC08_ERROR_PIPE_INFO_FAIL,         /* could not get pipes from the device */
+  USBTC08_ERROR_NOT_CALIBRATED,          /* no calibration date was found */
+  USBTC08_EROOR_PICOPP_TOO_OLD,
+	USBTC08_ERROR_PICOPP_TOO_OLD = USBTC08_EROOR_PICOPP_TOO_OLD,
+	USBTC08_ERROR_PICO_DRIVER_FUNCTION,
+
+  /*===========================
+  New User/Developererror codes
+  ============================*/
+  USBTC08_ERROR_COMMUNICATION           /*the PC has lost communication with unit*/
+}	USBTC08_ERROR;
+
+typedef enum enUSBTC08Units
+{
+  USBTC08_UNITS_CENTIGRADE,
+  USBTC08_UNITS_FAHRENHEIT,
+  USBTC08_UNITS_KELVIN,
+  USBTC08_UNITS_RANKINE,
+  USBTC08_MAX_UNITS = USBTC08_UNITS_RANKINE
+} USBTC08_UNITS;
+
+typedef enum enUSBTC08InfoLine
+{
+  USBTC08LINE_DRIVER_VERSION,
+  USBTC08LINE_KERNEL_DRIVER_VERSION,
+  USBTC08LINE_HARDWARE_VERSION,
+  USBTC08LINE_VARIANT_INFO,
+  USBTC08LINE_BATCH_AND_SERIAL,
+  USBTC08LINE_CAL_DATE,
+  USBTC08LINE_DRIVER_PATH
+} USBTC08_INFO_LINE;
+
+/* Structures *****************************************************/
+
+typedef struct tUSBTC08Info
+{
+  int16_t size;
+  int8_t  DriverVersion[USBTC08_MAX_VERSION_CHARS];
+  int16_t PicoppVersion;
+  int16_t HardwareVersion;
+  int16_t Variant;
+  int8_t  szSerial[USBTC08_MAX_SERIAL_CHARS];
+  int8_t  szCalDate[USBTC08_MAX_DATE_CHARS];
+} USBTC08_INFO, *LPUSBTC08_INFO;
+
+typedef struct tUSBTC08InfoV2
+{
+  int16_t size;
+  int8_t DriverVersion[USBTC08_MAX_VERSION_CHARS_V2];
+  int16_t UsbVersion;
+  int16_t HardwareVersion;
+  int16_t Variant;
+  int8_t szSerial[USBTC08_MAX_SERIAL_CHARS];
+  int8_t szCalDate[USBTC08_MAX_DATE_CHARS];
+} USBTC08_INFO_V2, *LPUSBTC08_INFO_V2;
+
+/*====================================================================
+    New USB TC08 API Calls
+
+    This set of functions should be used in preference to the
+    Legacy API calls at the bottom of this header file
+    (see also 'Shared API Calls' which are designed to be used
+    with the new API calls, but can also be used with legacy calls)
+=====================================================================*/
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_set_channel)
+(
+  int16_t handle,
+  int16_t channel,
+  int8_t  tc_type
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(usb_tc08_run)
+(
+  int16_t handle,
+  int32_t interval_ms
+);
+
+/* must be called at least once per minute to ensure no data is lost */
+PREF0 PREF1 int32_t PREF2 PREF3(usb_tc08_get_temp)
+(
+  int16_t  handle,
+  float   *temp_buffer,
+  int32_t *times_ms_buffer, /* wraps back to zero after 24 days */
+  int32_t  buffer_length,
+  int16_t *overflow,
+  int16_t  channel,
+  int16_t  units,
+  int16_t  fill_missing
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(usb_tc08_get_temp_deskew)
+(
+  int16_t  handle,
+  float   *temp_buffer,
+  int32_t *times_ms_buffer, /* wraps back to zero after 24 days */
+  int32_t  buffer_length,
+  int16_t *overflow,
+  int16_t  channel,
+  int16_t  units,
+  int16_t  fill_missing
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_single)
+(
+  int16_t  handle,
+  float   *temp,
+  int16_t *overflow_flags,
+  int16_t  units
+);
+
+/*==========================================================================
+    Shared API Calls
+
+    These functions are designed for use with the USB TC08,
+    however, they can (and should) still be used with the legacy API calls
+===========================================================================*/
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_open_unit)
+(
+  void
+);
+
+/* These two functions are used instead of usb_tc08_open_unit()
+ * if the calling application needs to perform operations while
+ * waiting for a unit to open
+ */
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_open_unit_async)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_open_unit_progress)
+(
+  int16_t *handle,
+  int16_t *percent_progress
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_close_unit)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_stop)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_set_mains)
+(
+  int16_t handle,
+  int16_t sixty_hertz
+);
+
+/* set-up all channels before calling this
+ * in legacy mode, this will be the fixed sampling rate
+ */
+PREF0 PREF1 int32_t PREF2 PREF3(usb_tc08_get_minimum_interval_ms)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_unit_info)
+(
+  int16_t handle, USBTC08_INFO * info
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_unit_info_v2)
+(
+  int16_t handle, USBTC08_INFO_V2* info
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_unit_info2)
+(
+  int16_t  handle,
+  int8_t  *string,
+  int16_t  string_length,
+  int16_t  line
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_formatted_info)
+(
+  int16_t  handle,
+  int8_t  *unit_info,
+  int16_t  string_length);
+
+/* pass 0 as the unit handle to get the last reason
+ * that usb_tc08_open_unit() failed
+ */
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_last_error)
+(
+  int16_t handle
+);
+
+/*====================================================================
+    Legacy API Calls
+
+    Provided to aid backwards compatibility with code written
+    for old TC08 Units (differences exist).
+
+    These functions should not be used in new code and are
+    deprecated for removal in a future version of the driver.
+=====================================================================*/
+
+/* Legacy defines
+ */
+#define CHANNELS_PER_TC08 8
+#define MAX_TC08_UNITS    64
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_run)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_set_channel)
+(
+  int16_t handle,
+  int16_t channel,
+  int8_t  tc_type,
+  int16_t filter_factor,
+  int16_t offset,
+  int16_t slope
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_get_temp)
+(
+  int32_t  *temp,
+  int16_t   handle,
+  uint16_t  channel,
+  uint16_t  filtered
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_get_cold_junction)
+(
+  int32_t * temp,
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_get_driver_version)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_get_version)
+(
+  int16_t *version,
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_get_cycle)
+(
+  int32_t *cycle,
+  int16_t handle
+);
+
+#endif

+ 1316 - 0
pico-tcp-service/pico-tcp-client/libps4000a/PicoStatus.h

@@ -0,0 +1,1316 @@
+/**************************************************************************
+*
+* Filename:    PicoStatus.h
+* Copyright:   Pico Technology Limited 2002 - 2022
+* Description:
+*
+* This header files defines the status codes returned by a
+*	Pico device, a PC Oscilloscope or Data Logger.
+*
+* In comments, "<API>" is a placeholder for the name of the scope or
+* data logger API. For example, for the ps5000a API, it stands for
+* "PS5000A" or "ps5000a".
+*
+*************************************************************************/
+#ifndef __PICOSTATUS_H__
+#define __PICOSTATUS_H__
+
+#include <stdint.h>
+
+typedef void * PICO_POINTER;
+
+#define	PICO_DRIVER_VERSION                         0x00000000UL
+#define	PICO_USB_VERSION                            0x00000001UL
+#define	PICO_HARDWARE_VERSION                       0x00000002UL
+#define	PICO_VARIANT_INFO                           0x00000003UL
+#define	PICO_BATCH_AND_SERIAL                       0x00000004UL
+#define	PICO_CAL_DATE                               0x00000005UL
+#define	PICO_KERNEL_VERSION                         0x00000006UL
+
+#define PICO_DIGITAL_HARDWARE_VERSION               0x00000007UL
+#define PICO_ANALOGUE_HARDWARE_VERSION              0x00000008UL
+
+#define PICO_FIRMWARE_VERSION_1                     0x00000009UL
+#define PICO_FIRMWARE_VERSION_2                     0x0000000AUL
+
+#define PICO_MAC_ADDRESS                            0x0000000BUL
+
+#define PICO_SHADOW_CAL                             0x0000000CUL
+
+#define PICO_IPP_VERSION                            0x0000000DUL
+
+#define PICO_DRIVER_PATH                            0x0000000EUL
+
+#define PICO_FIRMWARE_VERSION_3                     0x0000000FUL
+
+#define PICO_FRONT_PANEL_FIRMWARE_VERSION           0x00000010UL
+
+#define PICO_BOOTLOADER_VERSION						0x10000001UL
+
+typedef uint32_t PICO_INFO;
+
+// The PicoScope is functioning correctly.
+#define PICO_OK                                     0x00000000UL
+
+// An attempt has been made to open more than <API>_MAX_UNITS.
+#define PICO_MAX_UNITS_OPENED                       0x00000001UL
+
+// Not enough memory could be allocated on the host machine.
+#define PICO_MEMORY_FAIL                            0x00000002UL
+
+// No Pico Technology device could be found.
+#define PICO_NOT_FOUND                              0x00000003UL
+
+// Unable to download firmware.
+#define PICO_FW_FAIL                                0x00000004UL
+
+// The driver is busy opening a device.
+#define PICO_OPEN_OPERATION_IN_PROGRESS             0x00000005UL
+
+// An unspecified failure occurred.
+#define PICO_OPERATION_FAILED                       0x00000006UL
+
+// The PicoScope is not responding to commands from the PC.
+#define PICO_NOT_RESPONDING                         0x00000007UL
+
+// The configuration information in the PicoScope is corrupt or missing.
+#define PICO_CONFIG_FAIL                            0x00000008UL
+
+// The picopp.sys file is too old to be used with the device driver.
+#define PICO_KERNEL_DRIVER_TOO_OLD                  0x00000009UL
+
+// The EEPROM has become corrupt, so the device will use a default setting.
+#define PICO_EEPROM_CORRUPT                         0x0000000AUL
+
+// The operating system on the PC is not supported by this driver.
+#define PICO_OS_NOT_SUPPORTED                       0x0000000BUL
+
+// There is no device with the handle value passed.
+#define PICO_INVALID_HANDLE                         0x0000000CUL
+
+// A parameter value is not valid.
+#define PICO_INVALID_PARAMETER                      0x0000000DUL
+
+// The timebase is not supported or is invalid.
+#define PICO_INVALID_TIMEBASE                       0x0000000EUL
+
+// The voltage range is not supported or is invalid.
+#define PICO_INVALID_VOLTAGE_RANGE                  0x0000000FUL
+
+// The channel number is not valid on this device or no channels have been set.
+#define PICO_INVALID_CHANNEL                        0x00000010UL
+
+// The channel set for a trigger is not available on this device.
+#define PICO_INVALID_TRIGGER_CHANNEL                0x00000011UL
+
+// The channel set for a condition is not available on this device.
+#define PICO_INVALID_CONDITION_CHANNEL              0x00000012UL
+
+// The device does not have a signal generator.
+#define PICO_NO_SIGNAL_GENERATOR                    0x00000013UL
+
+// Streaming has failed to start or has stopped without user request.
+#define PICO_STREAMING_FAILED                       0x00000014UL
+
+// Block failed to start - a parameter may have been set wrongly.
+#define PICO_BLOCK_MODE_FAILED                      0x00000015UL
+
+// A parameter that was required is NULL.
+#define PICO_NULL_PARAMETER                         0x00000016UL
+
+// The current functionality is not available while using ETS capture mode.
+#define PICO_ETS_MODE_SET                           0x00000017UL
+
+// No data is available from a run block call.
+#define PICO_DATA_NOT_AVAILABLE                     0x00000018UL
+
+// The buffer passed for the information was too small.
+#define PICO_STRING_BUFFER_TO_SMALL                 0x00000019UL
+
+// ETS is not supported on this device.
+#define PICO_ETS_NOT_SUPPORTED                      0x0000001AUL
+
+// The auto trigger time is less than the time it will take to collect the pre-trigger data.
+#define PICO_AUTO_TRIGGER_TIME_TO_SHORT             0x0000001BUL
+
+// The collection of data has stalled as unread data would be overwritten.
+#define PICO_BUFFER_STALL                           0x0000001CUL
+
+// Number of samples requested is more than available in the current memory segment.
+#define PICO_TOO_MANY_SAMPLES                       0x0000001DUL
+
+// Not possible to create number of segments requested.
+#define PICO_TOO_MANY_SEGMENTS                      0x0000001EUL
+
+// A null pointer has been passed in the trigger function or one of the parameters is out of range.
+#define PICO_PULSE_WIDTH_QUALIFIER                  0x0000001FUL
+
+// One or more of the hold-off parameters are out of range.
+#define PICO_DELAY                                  0x00000020UL
+
+// One or more of the source details are incorrect.
+#define	PICO_SOURCE_DETAILS                         0x00000021UL
+
+// One or more of the conditions are incorrect.
+#define PICO_CONDITIONS                             0x00000022UL
+
+// The driver's thread is currently in the <API>Ready callback
+// function and therefore the action cannot be carried out.
+#define	PICO_USER_CALLBACK                          0x00000023UL
+
+// An attempt is being made to get stored data while streaming.
+// Either stop streaming by calling <API>Stop, or use <API>GetStreamingLatestValues.
+#define PICO_DEVICE_SAMPLING                        0x00000024UL
+
+// Data is unavailable because a run has not been completed.
+#define PICO_NO_SAMPLES_AVAILABLE                   0x00000025UL
+
+// The memory segment index is out of range.
+#define PICO_SEGMENT_OUT_OF_RANGE                   0x00000026UL
+
+// The device is busy so data cannot be returned yet.
+#define PICO_BUSY                                   0x00000027UL
+
+// The start time to get stored data is out of range.
+#define PICO_STARTINDEX_INVALID                     0x00000028UL
+
+// The information number requested is not a valid number.
+#define PICO_INVALID_INFO                           0x00000029UL
+
+// The handle is invalid so no information is available about the device.
+// Only PICO_DRIVER_VERSION is available.
+#define PICO_INFO_UNAVAILABLE                       0x0000002AUL
+
+// The sample interval selected for streaming is out of range.
+#define PICO_INVALID_SAMPLE_INTERVAL                0x0000002BUL
+
+// ETS is set but no trigger has been set. A trigger setting is required for ETS.
+#define PICO_TRIGGER_ERROR                          0x0000002CUL
+
+// Driver cannot allocate memory.
+#define PICO_MEMORY                                 0x0000002DUL
+
+// Incorrect parameter passed to the signal generator.
+#define PICO_SIG_GEN_PARAM                          0x0000002EUL
+
+// Conflict between the shots and sweeps parameters sent to the signal generator.
+#define PICO_SHOTS_SWEEPS_WARNING                   0x0000002FUL
+
+// A software trigger has been sent but the trigger source is not a software trigger.
+#define PICO_SIGGEN_TRIGGER_SOURCE                  0x00000030UL
+
+// An <API>SetTrigger call has found a conflict between the trigger source and the AUX output enable.
+#define PICO_AUX_OUTPUT_CONFLICT                    0x00000031UL
+
+// ETS mode is being used and AUX is set as an input.
+#define PICO_AUX_OUTPUT_ETS_CONFLICT                0x00000032UL
+
+// Attempt to set different EXT input thresholds set for signal generator and oscilloscope trigger.
+#define PICO_WARNING_EXT_THRESHOLD_CONFLICT         0x00000033UL
+
+// An <API>SetTrigger... function has set AUX as an output and the signal generator is using it as a trigger.
+#define PICO_WARNING_AUX_OUTPUT_CONFLICT            0x00000034UL
+
+// The combined peak-to-peak voltage and the analog offset voltage exceed the maximum voltage the signal generator can produce.
+#define PICO_SIGGEN_OUTPUT_OVER_VOLTAGE             0x00000035UL
+
+// NULL pointer passed as delay parameter.
+#define PICO_DELAY_NULL                             0x00000036UL
+
+// The buffers for overview data have not been set while streaming.
+#define PICO_INVALID_BUFFER                         0x00000037UL
+
+// The analog offset voltage is out of range.
+#define PICO_SIGGEN_OFFSET_VOLTAGE                  0x00000038UL
+
+// The analog peak-to-peak voltage is out of range.
+#define PICO_SIGGEN_PK_TO_PK                        0x00000039UL
+
+// A block collection has been cancelled.
+#define PICO_CANCELLED                              0x0000003AUL
+
+// The segment index is not currently being used.
+#define PICO_SEGMENT_NOT_USED                       0x0000003BUL
+
+// The wrong GetValues function has been called for the collection mode in use.
+#define PICO_INVALID_CALL                           0x0000003CUL
+
+#define PICO_GET_VALUES_INTERRUPTED                 0x0000003DUL
+
+// The function is not available.
+#define PICO_NOT_USED                               0x0000003FUL
+
+// The aggregation ratio requested is out of range.
+#define PICO_INVALID_SAMPLERATIO                    0x00000040UL
+
+// Device is in an invalid state.
+#define PICO_INVALID_STATE                          0x00000041UL
+
+// The number of segments allocated is fewer than the number of captures requested.
+#define PICO_NOT_ENOUGH_SEGMENTS                    0x00000042UL
+
+// A driver function has already been called and not yet finished.
+// Only one call to the driver can be made at any one time.
+#define PICO_DRIVER_FUNCTION                        0x00000043UL
+
+// Not used.
+#define PICO_RESERVED                               0x00000044UL
+
+// An invalid coupling type was specified in <API>SetChannel.
+#define PICO_INVALID_COUPLING                       0x00000045UL
+
+// An attempt was made to get data before a data buffer was defined.
+#define PICO_BUFFERS_NOT_SET                        0x00000046UL
+
+// The selected downsampling mode (used for data reduction) is not allowed.
+#define PICO_RATIO_MODE_NOT_SUPPORTED               0x00000047UL
+
+// Aggregation was requested in rapid block mode.
+#define PICO_RAPID_NOT_SUPPORT_AGGREGATION          0x00000048UL
+
+// An invalid parameter was passed to <API>SetTriggerChannelProperties(V2).
+#define PICO_INVALID_TRIGGER_PROPERTY               0x00000049UL
+
+// The driver was unable to contact the oscilloscope.
+#define PICO_INTERFACE_NOT_CONNECTED                0x0000004AUL
+
+// Resistance-measuring mode is not allowed in conjunction with the specified probe.
+#define PICO_RESISTANCE_AND_PROBE_NOT_ALLOWED       0x0000004BUL
+
+// The device was unexpectedly powered down.
+#define PICO_POWER_FAILED                           0x0000004CUL
+
+// A problem occurred in <API>SetSigGenBuiltIn or <API>SetSigGenArbitrary.
+#define PICO_SIGGEN_WAVEFORM_SETUP_FAILED           0x0000004DUL
+
+// FPGA not successfully set up.
+#define PICO_FPGA_FAIL                              0x0000004EUL
+
+#define PICO_POWER_MANAGER                          0x0000004FUL
+
+// An impossible analog offset value was specified in <API>SetChannel.
+#define PICO_INVALID_ANALOGUE_OFFSET                0x00000050UL
+
+// There is an error within the device hardware.
+#define PICO_PLL_LOCK_FAILED                        0x00000051UL
+
+// There is an error within the device hardware.
+#define PICO_ANALOG_BOARD                           0x00000052UL
+
+// Unable to configure the signal generator.
+#define PICO_CONFIG_FAIL_AWG                        0x00000053UL
+
+// The FPGA cannot be initialized, so unit cannot be opened.
+#define PICO_INITIALISE_FPGA                        0x00000054UL
+
+// The frequency for the external clock is not within 15% of the nominal value.
+#define PICO_EXTERNAL_FREQUENCY_INVALID             0x00000056UL
+
+// The FPGA could not lock the clock signal.
+#define PICO_CLOCK_CHANGE_ERROR                     0x00000057UL
+
+// You are trying to configure the AUX input as both a trigger and a reference clock.
+#define PICO_TRIGGER_AND_EXTERNAL_CLOCK_CLASH       0x00000058UL
+
+// You are trying to configure the AUX input as both a pulse width qualifier and a reference clock.
+#define PICO_PWQ_AND_EXTERNAL_CLOCK_CLASH           0x00000059UL
+
+// The requested scaling file cannot be opened.
+#define PICO_UNABLE_TO_OPEN_SCALING_FILE            0x0000005AUL
+
+// The frequency of the memory is reporting incorrectly.
+#define PICO_MEMORY_CLOCK_FREQUENCY                 0x0000005BUL
+
+// The I2C that is being actioned is not responding to requests.
+#define PICO_I2C_NOT_RESPONDING                     0x0000005CUL
+
+// There are no captures available and therefore no data can be returned.
+#define PICO_NO_CAPTURES_AVAILABLE                  0x0000005DUL
+
+// The number of trigger channels is greater than 4,
+// except for a PicoScope 4824 where 8 channels are allowed for rising/falling/rising_or_falling trigger directions.
+#define PICO_TOO_MANY_TRIGGER_CHANNELS_IN_USE				0x0000005FUL
+
+// If you have specified a trigger direction which is not allowed, for example specifying PICO_ABOVE
+// without another condition which crosses a threshold on another channel.
+#define PICO_INVALID_TRIGGER_DIRECTION							0x00000060UL
+
+// When more than 4 trigger channels are set and their trigger condition states are not <API>_CONDITION_TRUE.
+#define PICO_INVALID_TRIGGER_STATES									0x00000061UL
+
+// The capture mode the device is currently running in does not support the current request.
+#define PICO_NOT_USED_IN_THIS_CAPTURE_MODE          0x0000005EUL
+
+#define PICO_GET_DATA_ACTIVE                        0x00000103UL
+
+// Codes 104 to 10B are used by the PT104 (USB) when connected via the Network Socket.
+
+// The device is currently connected via the IP Network socket and thus the call made is not supported.
+#define PICO_IP_NETWORKED                           0x00000104UL
+
+// An incorrect IP address has been passed to the driver.
+#define PICO_INVALID_IP_ADDRESS                     0x00000105UL
+
+// The IP socket has failed.
+#define PICO_IPSOCKET_FAILED                        0x00000106UL
+
+// The IP socket has timed out.
+#define PICO_IPSOCKET_TIMEDOUT                      0x00000107UL
+
+// Failed to apply the requested settings.
+#define PICO_SETTINGS_FAILED                        0x00000108UL
+
+// The network connection has failed.
+#define PICO_NETWORK_FAILED                         0x00000109UL
+
+// Unable to load the WS2 DLL.
+#define PICO_WS2_32_DLL_NOT_LOADED                  0x0000010AUL
+
+// The specified IP port is invalid.
+#define PICO_INVALID_IP_PORT                        0x0000010BUL
+
+// The type of coupling requested is not supported on the opened device.
+#define PICO_COUPLING_NOT_SUPPORTED                 0x0000010CUL
+
+// Bandwidth limiting is not supported on the opened device.
+#define PICO_BANDWIDTH_NOT_SUPPORTED                0x0000010DUL
+
+// The value requested for the bandwidth limit is out of range.
+#define PICO_INVALID_BANDWIDTH                      0x0000010EUL
+
+// The arbitrary waveform generator is not supported by the opened device.
+#define PICO_AWG_NOT_SUPPORTED                      0x0000010FUL
+
+// Data has been requested with ETS mode set but run block has not been called,
+// or stop has been called.
+#define PICO_ETS_NOT_RUNNING                        0x00000110UL
+
+// White noise output is not supported on the opened device.
+#define PICO_SIG_GEN_WHITENOISE_NOT_SUPPORTED       0x00000111UL
+
+// The wave type requested is not supported by the opened device.
+#define PICO_SIG_GEN_WAVETYPE_NOT_SUPPORTED         0x00000112UL
+
+// The requested digital port number is out of range (MSOs only).
+#define PICO_INVALID_DIGITAL_PORT                   0x00000113UL
+
+// The digital channel is not in the range <API>_DIGITAL_CHANNEL0 to
+// <API>_DIGITAL_CHANNEL15, the digital channels that are supported.
+#define PICO_INVALID_DIGITAL_CHANNEL                0x00000114UL
+
+// The digital trigger direction is not a valid trigger direction and should be equal
+// in value to one of the <API>_DIGITAL_DIRECTION enumerations.
+#define PICO_INVALID_DIGITAL_TRIGGER_DIRECTION      0x00000115UL
+
+// Signal generator does not generate pseudo-random binary sequence.
+#define	PICO_SIG_GEN_PRBS_NOT_SUPPORTED             0x00000116UL
+
+// When a digital port is enabled, ETS sample mode is not available for use.
+#define PICO_ETS_NOT_AVAILABLE_WITH_LOGIC_CHANNELS  0x00000117UL
+
+// There has been no new sample taken, this value has already been returned previously.
+#define PICO_WARNING_REPEAT_VALUE                   0x00000118UL
+
+// The DC power supply is connected.
+#define PICO_POWER_SUPPLY_CONNECTED                 0x00000119UL
+
+// The DC power supply is not connected.
+// For many 4+ Channel devices this will mean a restricted feature set is offered e.g. for a 4 channel device - C and D are usually disabled.
+// Check the respective API programmers guide of your device for the full details.
+#define PICO_POWER_SUPPLY_NOT_CONNECTED             0x0000011AUL
+
+// Incorrect power mode passed for current power source.
+#define PICO_POWER_SUPPLY_REQUEST_INVALID           0x0000011BUL
+
+// The supply voltage from the USB source is too low.
+#define PICO_POWER_SUPPLY_UNDERVOLTAGE              0x0000011CUL
+
+// The oscilloscope is in the process of capturing data.
+#define PICO_CAPTURING_DATA                         0x0000011DUL
+
+// A USB 3.0 device is connected to a non-USB 3.0 port.
+#define PICO_USB3_0_DEVICE_NON_USB3_0_PORT          0x0000011EUL
+
+// A function has been called that is not supported by the current device.
+#define PICO_NOT_SUPPORTED_BY_THIS_DEVICE           0x0000011FUL
+
+// The device resolution is invalid (out of range).
+#define PICO_INVALID_DEVICE_RESOLUTION              0x00000120UL
+
+// The number of channels that can be enabled is limited in 15 and 16-bit modes.
+// (Flexible Resolution Oscilloscopes only)
+#define PICO_INVALID_NUMBER_CHANNELS_FOR_RESOLUTION 0x00000121UL
+
+// USB power not sufficient for all requested channels.
+#define PICO_CHANNEL_DISABLED_DUE_TO_USB_POWERED    0x00000122UL
+
+// The signal generator does not have a configurable DC offset.
+#define PICO_SIGGEN_DC_VOLTAGE_NOT_CONFIGURABLE     0x00000123UL
+
+// An attempt has been made to define pre-trigger delay without first enabling a trigger.
+#define PICO_NO_TRIGGER_ENABLED_FOR_TRIGGER_IN_PRE_TRIG  0x00000124UL
+
+// An attempt has been made to define pre-trigger delay without first arming a trigger.
+#define PICO_TRIGGER_WITHIN_PRE_TRIG_NOT_ARMED           0x00000125UL
+
+// Pre-trigger delay and post-trigger delay cannot be used at the same time.
+#define PICO_TRIGGER_WITHIN_PRE_NOT_ALLOWED_WITH_DELAY   0x00000126UL
+
+// The array index points to a nonexistent trigger.
+#define PICO_TRIGGER_INDEX_UNAVAILABLE                   0x00000127UL
+
+#define PICO_AWG_CLOCK_FREQUENCY									0x00000128UL
+
+// There are more than 4 analog channels with a trigger condition set.
+#define PICO_TOO_MANY_CHANNELS_IN_USE							0x00000129UL
+
+// The condition parameter is a null pointer.
+#define PICO_NULL_CONDITIONS											0x0000012AUL
+
+// There is more than one condition pertaining to the same channel.
+#define PICO_DUPLICATE_CONDITION_SOURCE						0x0000012BUL
+
+// The parameter relating to condition information is out of range.
+#define PICO_INVALID_CONDITION_INFO								0x0000012CUL
+
+// Reading the meta data has failed.
+#define PICO_SETTINGS_READ_FAILED									0x0000012DUL
+
+// Writing the meta data has failed.
+#define PICO_SETTINGS_WRITE_FAILED								0x0000012EUL
+
+// A parameter has a value out of the expected range.
+#define PICO_ARGUMENT_OUT_OF_RANGE								0x0000012FUL
+
+// The driver does not support the hardware variant connected.
+#define PICO_HARDWARE_VERSION_NOT_SUPPORTED				0x00000130UL
+
+// The driver does not support the digital hardware variant connected.
+#define PICO_DIGITAL_HARDWARE_VERSION_NOT_SUPPORTED				0x00000131UL
+
+// The driver does not support the analog hardware variant connected.
+#define PICO_ANALOGUE_HARDWARE_VERSION_NOT_SUPPORTED				0x00000132UL
+
+// Converting a channel's ADC value to resistance has failed.
+#define PICO_UNABLE_TO_CONVERT_TO_RESISTANCE			0x00000133UL
+
+// The channel is listed more than once in the function call.
+#define PICO_DUPLICATED_CHANNEL										0x00000134UL
+
+// The range cannot have resistance conversion applied.
+#define PICO_INVALID_RESISTANCE_CONVERSION				0x00000135UL
+
+// An invalid value is in the max buffer.
+#define PICO_INVALID_VALUE_IN_MAX_BUFFER					0x00000136UL
+
+// An invalid value is in the min buffer.
+#define PICO_INVALID_VALUE_IN_MIN_BUFFER					0x00000137UL
+
+// When calculating the frequency for phase conversion,
+// the frequency is greater than that supported by the current variant.
+#define PICO_SIGGEN_FREQUENCY_OUT_OF_RANGE				0x00000138UL
+
+// The device's EEPROM is corrupt. Contact Pico Technology support: https://www.picotech.com/tech-support.
+#define PICO_EEPROM2_CORRUPT											0x00000139UL
+
+// The EEPROM has failed.
+#define PICO_EEPROM2_FAIL													0x0000013AUL
+
+// The serial buffer is too small for the required information.
+#define PICO_SERIAL_BUFFER_TOO_SMALL							0x0000013BUL
+
+// The signal generator trigger and the external clock have both been set.
+// This is not allowed.
+#define PICO_SIGGEN_TRIGGER_AND_EXTERNAL_CLOCK_CLASH 0x0000013CUL
+
+// The AUX trigger was enabled and the external clock has been enabled,
+// so the AUX has been automatically disabled.
+#define PICO_WARNING_SIGGEN_AUXIO_TRIGGER_DISABLED 0x0000013DUL
+
+// The AUX I/O was set as a scope trigger and is now being set as a signal generator
+// gating trigger. This is not allowed.
+#define PICO_SIGGEN_GATING_AUXIO_NOT_AVAILABLE	 	 0x00000013EUL
+
+// The AUX I/O was set by the signal generator as a gating trigger and is now being set
+// as a scope trigger. This is not allowed.
+#define PICO_SIGGEN_GATING_AUXIO_ENABLED				 	 0x00000013FUL
+
+// A resource has failed to initialise.
+#define PICO_RESOURCE_ERROR												 0x00000140UL
+
+// The temperature type is out of range.
+#define PICO_TEMPERATURE_TYPE_INVALID							 0x000000141UL
+
+// A requested temperature type is not supported on this device.
+#define PICO_TEMPERATURE_TYPE_NOT_SUPPORTED				 0x000000142UL
+
+// A read/write to the device has timed out.
+#define PICO_TIMEOUT															 0x00000143UL
+
+// The device cannot be connected correctly.
+#define PICO_DEVICE_NOT_FUNCTIONING							   0x00000144UL
+
+// The driver has experienced an unknown error and is unable to recover from this error.
+#define PICO_INTERNAL_ERROR												 0x00000145UL
+
+// Used when opening units via IP and more than multiple units have the same IP address.
+#define PICO_MULTIPLE_DEVICES_FOUND								 0x00000146UL
+
+#define PICO_WARNING_NUMBER_OF_SEGMENTS_REDUCED 	 					0x00000147UL
+
+// The calibration pin states argument is out of range.
+#define PICO_CAL_PINS_STATES											0x00000148UL
+
+// The calibration pin frequency argument is out of range.
+#define PICO_CAL_PINS_FREQUENCY										0x00000149UL
+
+// The calibration pin amplitude argument is out of range.
+#define PICO_CAL_PINS_AMPLITUDE										0x0000014AUL
+
+// The calibration pin wavetype argument is out of range.
+#define PICO_CAL_PINS_WAVETYPE										0x0000014BUL
+
+// The calibration pin offset argument is out of range.
+#define PICO_CAL_PINS_OFFSET											0x0000014CUL
+
+// The probe's identity has a problem.
+#define PICO_PROBE_FAULT													0x0000014DUL
+
+// The probe has not been identified.
+#define PICO_PROBE_IDENTITY_UNKNOWN								0x0000014EUL
+
+// Enabling the probe would cause the device to exceed the allowable current limit.
+#define PICO_PROBE_POWER_DC_POWER_SUPPLY_REQUIRED 0x0000014FUL
+
+// The DC power supply is connected; enabling the probe would cause the device to exceed the
+// allowable current limit.
+#define PICO_PROBE_NOT_POWERED_WITH_DC_POWER_SUPPLY 0x00000150UL
+
+// Failed to complete probe configuration.
+#define	PICO_PROBE_CONFIG_FAILURE									0x00000151UL
+
+// Failed to set the callback function, as currently in current callback function.
+#define	PICO_PROBE_INTERACTION_CALLBACK						0x00000152UL
+
+// The probe has been verified but not known on this driver.
+#define	PICO_UNKNOWN_INTELLIGENT_PROBE						0x00000153UL
+
+// The intelligent probe cannot be verified.
+#define	PICO_INTELLIGENT_PROBE_CORRUPT						0x00000154UL
+
+// The callback is null, probe collection will only start when
+// first callback is a none null pointer.
+#define PICO_PROBE_COLLECTION_NOT_STARTED					0x00000155UL
+
+// The current drawn by the probe(s) has exceeded the allowed limit.
+#define PICO_PROBE_POWER_CONSUMPTION_EXCEEDED    0x00000156UL
+
+// The channel range limits have changed due to connecting or disconnecting a probe
+// the channel has been enabled.
+#define PICO_WARNING_PROBE_CHANNEL_OUT_OF_SYNC 0x00000157UL
+
+#define PICO_ENDPOINT_MISSING									 0x00000158UL
+#define PICO_UNKNOWN_ENDPOINT_REQUEST							 0x00000159UL
+
+// The ADC on board the device has not been correctly identified.
+#define PICO_ADC_TYPE_ERROR													0x0000015AUL
+
+#define PICO_FPGA2_FAILED														0x0000015BUL
+
+#define PICO_FPGA2_DEVICE_STATUS										0x0000015CUL
+
+#define PICO_ENABLE_PROGRAM_FPGA2_FAILED						0x0000015DUL
+#define PICO_NO_CHANNELS_OR_PORTS_ENABLED									0x0000015EUL
+
+#define PICO_INVALID_RATIO_MODE											0x0000015FUL
+
+#define PICO_READS_NOT_SUPPORTED_IN_CURRENT_CAPTURE_MODE 0x00000160UL
+
+// These selection tests can be masked together to show that mode than one read selection has failed the tests,
+// therefore theses error codes cover 0x00000161UL to 0x0000016FUL.
+#define PICO_TRIGGER_READ_SELECTION_CHECK_FAILED						0x00000161UL
+#define PICO_DATA_READ1_SELECTION_CHECK_FAILED						0x00000162UL
+#define PICO_DATA_READ2_SELECTION_CHECK_FAILED						0x00000164UL
+#define PICO_DATA_READ3_SELECTION_CHECK_FAILED						0x00000168UL
+
+// The requested read is not one of the reads available in enPicoReadSelection.
+#define PICO_READ_SELECTION_OUT_OF_RANGE						0x00000170UL
+
+// The downsample ratio options cannot be combined together for this request.
+#define PICO_MULTIPLE_RATIO_MODES										0x00000171UL
+
+// The enPicoReadSelection request has no samples available.
+#define PICO_NO_SAMPLES_READ			                  0x00000172UL
+
+// The enPicoReadSelection did not include one of the downsample ratios now requested.
+#define PICO_RATIO_MODE_NOT_REQUESTED								0x00000173UL
+
+// No read requests have been made.
+#define PICO_NO_USER_READ_REQUESTS_SET							0x00000174UL
+
+// The parameter for <number of values> cannot be zero.
+#define PICO_ZERO_SAMPLES_INVALID										0x00000175UL
+
+// The analog hardware cannot be identified; contact Pico Technology Technical Support.
+#define	PICO_ANALOGUE_HARDWARE_MISSING							0x00000176UL
+
+// Setting of the analog hardware pins failed.
+#define PICO_ANALOGUE_HARDWARE_PINS									0x00000177UL
+
+// An SMPS fault has occurred.
+#define PICO_ANALOGUE_HARDWARE_SMPS_FAULT						0x00000178UL
+
+// There appears to be a conflict between the expected and actual hardware in the device; contact Pico Technology Technical Support.
+#define PICO_DIGITAL_ANALOGUE_HARDWARE_CONFLICT			0x00000179UL
+
+// One or more of the enPicoRatioMode requested do not have a data buffer set.
+#define PICO_RATIO_MODE_BUFFER_NOT_SET							0x0000017AUL
+
+// The resolution is valid but not supported by the opened device.
+#define PICO_RESOLUTION_NOT_SUPPORTED_BY_VARIANT		0x0000017BUL
+
+// The requested trigger threshold is out of range for the current device resolution.
+#define PICO_THRESHOLD_OUT_OF_RANGE									0x0000017CUL
+
+// The simple trigger only supports upper edge direction options.
+#define PICO_INVALID_SIMPLE_TRIGGER_DIRECTION				0x0000017DUL
+
+// The aux trigger is not supported on this variant.
+#define PICO_AUX_NOT_SUPPORTED											0x0000017EUL
+
+// The trigger directions pointer may not be null.
+#define PICO_NULL_DIRECTIONS												0x0000017FUL
+
+// The trigger channel properties pointer may not be null.
+#define PICO_NULL_CHANNEL_PROPERTIES								0x00000180UL
+
+// A trigger is set on a channel that has not been enabled.
+#define PICO_TRIGGER_CHANNEL_NOT_ENABLED						0x00000181UL
+
+// A trigger condition has been set but a trigger property not set.
+#define PICO_CONDITION_HAS_NO_TRIGGER_PROPERTY			0x00000182UL
+
+// When requesting trigger data, this option can only be combined with the segment header ratio mode flag.
+#define PICO_RATIO_MODE_TRIGGER_MASKING_INVALID			0x00000183UL
+
+// The trigger data buffer must be 40 or more samples in size.
+#define PICO_TRIGGER_DATA_REQUIRES_MIN_BUFFER_SIZE_OF_40_SAMPLES 0x00000184UL
+
+// The number of requested waveforms is greater than the number of memory segments allocated.
+#define PICO_NO_OF_CAPTURES_OUT_OF_RANGE						0x00000185UL
+
+// When requesting segment header information, the segment header does not require a data buffer,
+// to get the segment information use GetTriggerInfo.
+#define PICO_RATIO_MODE_SEGMENT_HEADER_DOES_NOT_REQUIRE_BUFFERS	0x00000186UL
+
+// Use GetTriggerInfo to retrieve the segment header information.
+#define PICO_FOR_SEGMENT_HEADER_USE_GETTRIGGERINFO	0x00000187UL
+
+// A read request has not been set.
+#define PICO_READ_NOT_SET														0x00000188UL
+
+// The expected and actual states of the ADCs do not match.
+#define PICO_ADC_SETTING_MISMATCH										0x00000189UL
+
+// The requested data type is not one of the enPicoDataType listed.
+#define PICO_DATATYPE_INVALID												0x0000018AUL
+
+// The down sample ratio mode requested does not support the enPicoDataType option chosen.
+#define PICO_RATIO_MODE_DOES_NOT_SUPPORT_DATATYPE		0x0000018BUL
+
+// The channel combination is not valid for the resolution.
+#define PICO_CHANNEL_COMBINATION_NOT_VALID_IN_THIS_RESOLUTION 0x0000018CUL
+
+
+#define PICO_USE_8BIT_RESOLUTION										0x0000018DUL
+
+// The buffer for minimum data values and maximum data values are the same buffers.
+#define PICO_AGGREGATE_BUFFERS_SAME_POINTER					0x0000018EUL
+
+// The read request number of samples requested for an overlapped operation are more
+// than the total number of samples to capture.
+#define PICO_OVERLAPPED_READ_VALUES_OUT_OF_RANGE		0x0000018FUL
+
+// The overlapped read request has more segments specified than segments allocated.
+#define PICO_OVERLAPPED_READ_SEGMENTS_OUT_OF_RANGE	0x00000190UL
+
+// The number of channel combinations available are greater than the array size received.
+#define PICO_CHANNELFLAGSCOMBINATIONS_ARRAY_SIZE_TOO_SMALL 0x00000191UL
+
+// The number of captures is larger than the maximum number of segments allowed for the device variant.
+#define PICO_CAPTURES_EXCEEDS_NO_OF_SUPPORTED_SEGMENTS 0x00000192UL
+
+// The time unit requested is not one of the listed enPicoTimeUnits.
+#define PICO_TIME_UNITS_OUT_OF_RANGE								0x00000193UL
+
+// The number of samples parameter may not be zero.
+#define PICO_NO_SAMPLES_REQUESTED										0x00000194UL
+
+// The action requested is not listed in enPicoAction.
+#define PICO_INVALID_ACTION													0x00000195UL
+
+// When adding buffers for the same read request the buffers for all ratio mode requests have to be the same size.
+#define PICO_NO_OF_SAMPLES_NEED_TO_BE_EQUAL_WHEN_ADDING_BUFFERS 0x00000196UL
+
+// The data is being processed but there is no empty data buffers available, a new data buffer needs to be set sent to the driver
+// so that the data can be processed.
+#define PICO_WAITING_FOR_DATA_BUFFERS								0x00000197UL
+
+// when streaming data, only one read option is available.
+#define PICO_STREAMING_ONLY_SUPPORTS_ONE_READ				0x00000198UL
+
+// A clear read request is not one of the enPicoAction listed.
+#define PICO_CLEAR_DATA_BUFFER_INVALID					0x00000199UL
+
+// The combination of action flags are not allowed.
+#define PICO_INVALID_ACTION_FLAGS_COMBINATION				0x0000019AUL
+
+//  PICO_ADD request has been made but both data buffers are set to null and so there is nowhere to put the data.
+#define PICO_BOTH_MIN_AND_MAX_NULL_BUFFERS_CANNOT_BE_ADDED 0x0000019BUL
+
+// A conflict between the data buffers being set has occurred. Please use the PICO_CLEAR_ALL action to reset.
+#define PICO_CONFLICT_IN_SET_DATA_BUFFERS_CALL_REMOVE_DATA_BUFFER_TO_RESET 0x0000019CUL
+
+// While processing data, buffers cannot be removed from the data buffers list.
+#define PICO_REMOVING_DATA_BUFFER_ENTRIES_NOT_ALLOWED_WHILE_DATA_PROCESSING  0x0000019DUL
+
+//  An USB request has failed.
+#define PICO_CYUSB_REQUEST_FAILED						0x00000200UL
+
+// A request has been made to retrieve the latest streaming data, but with either a null pointer or an array size set to zero.
+#define PICO_STREAMING_DATA_REQUIRED				0x00000201UL
+
+// A buffer being set has a length that is invalid (ie less than zero).
+#define PICO_INVALID_NUMBER_OF_SAMPLES			0x00000202UL
+
+// The distribution size may not be zero.
+#define PICO_INVALID_DISTRIBUTION						0x00000203UL
+
+// The buffer length in bytes is greater than a 4-byte word.
+#define PICO_BUFFER_LENGTH_GREATER_THAN_INT32_T 0x00000204UL
+
+// The PLL has failed.
+#define PICO_PLL_MUX_OUT_FAILED             0x00000209UL
+
+// Pulse width only supports one direction.
+#define PICO_ONE_PULSE_WIDTH_DIRECTION_ALLOWED 0x0000020AUL
+
+// There is no external trigger available on the device specified by the handle.
+#define PICO_EXTERNAL_TRIGGER_NOT_SUPPORTED 0x0000020BUL
+
+// The condition parameter is a null pointer.
+#define PICO_NO_TRIGGER_CONDITIONS_SET							0x0000020CUL
+
+// The number of trigger channel properties it outside the allowed range (is less than zero).
+#define PICO_NO_OF_CHANNEL_TRIGGER_PROPERTIES_OUT_OF_RANGE 0x0000020DUL
+
+// A probe has been plugged into a channel, but can not be identified correctly.
+#define PICO_PROBE_COMPONENT_ERROR 0x0000020EUL
+
+// The probe is incompatible with the device channel it is connected to. This could lead to error in the measurements.
+#define PICO_INCOMPATIBLE_PROBE 0x0000020FUL
+
+// The requested channel for ETS triggering is not supported.
+#define PICO_INVALID_TRIGGER_CHANNEL_FOR_ETS              0x00000210UL
+
+// While the device is streaming the get values method is not available
+#define PICO_NOT_AVAILABLE_WHEN_STREAMING_IS_RUNNING 0x00000211UL
+
+// the requested state is not one of the enSharedTriggerWithinPreTrigger values
+#define PICO_INVALID_TRIGGER_WITHIN_PRE_TRIGGER_STATE 0x00000212UL
+
+// the number of captures have to be greater than zero
+#define PICO_ZERO_NUMBER_OF_CAPTURES_INVALID 0x00000213UL
+
+// the quantifier for a pointer, defining the length in bytes is invalid
+#define PICO_INVALID_LENGTH 0x00000214UL
+
+// the trigger delay is greater than supported by the hardware
+#define PICO_TRIGGER_DELAY_OUT_OF_RANGE 0x00000300UL
+
+// the requested threshold direction is not allowed with the specified channel
+#define PICO_INVALID_THRESHOLD_DIRECTION 0x00000301UL
+
+// the requested threshold mode is not allowed with the specified channel
+#define PICO_INVALID_THRESHOLD_MODE 0x00000302UL
+
+// The timebase is not supported or is invalid.
+#define PICO_TIMEBASE_NOT_SUPPORTED_BY_RESOLUTION 0x00000303UL
+
+// The device variant is not supported by this current driver.
+#define PICO_INVALID_VARIANT															0x00001000UL
+
+// The actual memory module does not match the expected memory module.
+#define PICO_MEMORY_MODULE_ERROR													0x00001001UL
+
+// A null pointer has been passed in the trigger function or one of the parameters is out of range.
+#define PICO_PULSE_WIDTH_QUALIFIER_LOWER_UPPER_CONFILCT  0x00002000UL
+
+// The pulse width qualifier type is not one of the listed options.
+#define PICO_PULSE_WIDTH_QUALIFIER_TYPE  0x00002001UL
+
+// The pulse width qualifier direction is not one of the listed options.
+#define PICO_PULSE_WIDTH_QUALIFIER_DIRECTION 0x00002002UL
+
+// The threshold range is not one of the listed options.
+#define PICO_THRESHOLD_MODE_OUT_OF_RANGE 0x00002003UL
+
+// The trigger direction and pulse width option conflict with each other.
+#define PICO_TRIGGER_AND_PULSEWIDTH_DIRECTION_IN_CONFLICT 0x00002004UL
+
+// The thresholds upper limits and thresholds lower limits conflict with each other.
+#define PICO_THRESHOLD_UPPER_LOWER_MISMATCH 0x00002005UL
+
+// The pulse width lower count is out of range.
+#define PICO_PULSE_WIDTH_LOWER_OUT_OF_RANGE	0x00002006UL
+
+// The pulse width upper count is out of range.
+#define PICO_PULSE_WIDTH_UPPER_OUT_OF_RANGE 0x00002007UL
+
+// The devices front panel has caused an error.
+#define PICO_FRONT_PANEL_ERROR 0x00002008UL
+
+// The actual and expected mode of the front panel do not match.
+#define PICO_FRONT_PANEL_MODE 0x0000200BUL
+
+// A front panel feature is not available or failed to configure.
+#define PICO_FRONT_PANEL_FEATURE 0x0000200CUL
+
+// When setting the pulse width conditions either the pointer is null or the number of conditions is set to zero.
+#define PICO_NO_PULSE_WIDTH_CONDITIONS_SET	0x0000200DUL
+
+// a trigger condition exists for a port, but the port has not been enabled
+#define PICO_TRIGGER_PORT_NOT_ENABLED 0x0000200EUL
+
+// a trigger condition exists for a port, but no digital channel directions have been set
+#define PICO_DIGITAL_DIRECTION_NOT_SET 0x0000200FUL
+
+#define PICO_I2C_DEVICE_INVALID_READ_COMMAND 0x00002010UL
+
+#define PICO_I2C_DEVICE_INVALID_RESPONSE 0x00002011UL
+
+#define PICO_I2C_DEVICE_INVALID_WRITE_COMMAND 0x00002012UL
+
+#define PICO_I2C_DEVICE_ARGUMENT_OUT_OF_RANGE 0x00002013UL
+
+// The actual and expected mode do not match.
+#define PICO_I2C_DEVICE_MODE 0x00002014UL
+
+// While trying to configure the device, set up failed.
+#define PICO_I2C_DEVICE_SETUP_FAILED 0x00002015UL
+
+// A feature is not available or failed to configure.
+#define PICO_I2C_DEVICE_FEATURE 0x00002016UL
+
+// The device did not pass the validation checks.
+#define PICO_I2C_DEVICE_VALIDATION_FAILED 0x00002017UL
+
+#define PICO_INTERNAL_HEADER_ERROR 0x00002018UL
+
+// The device couldn't write the channel settings due to a hardware fault
+#define PICO_FAILED_TO_WRITE_HARDWARE_FAULT 0x00002019UL
+
+// The number of MSO's edge transitions being set is not supported by this device (RISING, FALLING, or RISING_OR_FALLING).
+#define PICO_MSO_TOO_MANY_EDGE_TRANSITIONS_WHEN_USING_PULSE_WIDTH 0x00003000UL
+
+// A probe LED position requested is not one of the available probe positions in the ProbeLedPosition enum.
+#define PICO_INVALID_PROBE_LED_POSITION 0x00003001UL
+
+// The LED position is not supported by the selected variant.
+#define PICO_PROBE_LED_POSITION_NOT_SUPPORTED 0x00003002UL
+
+// A channel has more than one of the same LED position in the ProbeChannelLedSetting struct.
+#define PICO_DUPLICATE_PROBE_CHANNEL_LED_POSITION 0x00003003UL
+
+// Setting the probes LED has failed.
+#define PICO_PROBE_LED_FAILURE 0x00003004UL
+
+// Probe is not supported by the selected variant.
+#define PICO_PROBE_NOT_SUPPORTED_BY_THIS_DEVICE 0x00003005UL
+
+// The probe name is not in the list of enPicoConnectProbe enums.
+#define PICO_INVALID_PROBE_NAME 0x00003006UL
+
+// The number of colour settings are zero or a null pointer passed to the function.
+#define PICO_NO_PROBE_COLOUR_SETTINGS 0x00003007UL
+
+// Channel has no probe connected to it.
+#define PICO_NO_PROBE_CONNECTED_ON_REQUESTED_CHANNEL 0x00003008UL
+
+// Connected probe does not require calibration.
+#define PICO_PROBE_DOES_NOT_REQUIRE_CALIBRATION 0x00003009UL
+
+// Connected probe could not be calibrated - hardware fault is a possible cause.
+#define PICO_PROBE_CALIBRATION_FAILED 0x0000300AUL
+
+// A probe has been connected, but the version is not recognised.
+#define PICO_PROBE_VERSION_ERROR 0x0000300BUL
+
+// The channel with the frequency counter enabled has a probe connected that does not support this feature
+#define PICO_PROBE_DOES_NOT_SUPPORT_FREQUENCY_COUNTER 0x0000300CUL
+
+// The requested trigger time is to long for the selected variant.
+#define PICO_AUTO_TRIGGER_TIME_TOO_LONG   0x00004000UL
+
+// The MSO pod did not pass the validation checks.
+#define PICO_MSO_POD_VALIDATION_FAILED 0x00005000UL
+
+// No MSO pod found on the requested digital port.
+#define PICO_NO_MSO_POD_CONNECTED 0x00005001UL
+
+// the digital port enum value is not in the enPicoDigitalPortHysteresis declaration
+#define PICO_DIGITAL_PORT_HYSTERESIS_OUT_OF_RANGE 0x00005002UL
+
+#define PICO_MSO_POD_FAILED_UNIT 0x00005003UL
+
+// The device's EEPROM is corrupt. Contact Pico Technology support: https://www.picotech.com/tech-support.
+#define PICO_ATTENUATION_FAILED 0x00005004UL
+
+// a channel set to the 50Ohm Path has Tripped due to the input signal
+#define PICO_DC_50OHM_OVERVOLTAGE_TRIPPED 0x00005005UL
+
+// The MSO pod over current protection activated, unplug and replug the MSO pod 
+#define PICO_MSO_OVER_CURRENT_TRIPPED 0x00005006UL
+
+// Status error for when the device has overheated.
+#define PICO_NOT_RESPONDING_OVERHEATED 0x00005010UL
+
+// waiting for the device to capture timed out
+#define PICO_HARDWARE_CAPTURE_TIMEOUT 0x00006000UL
+
+// waiting for the device be ready for capture timed out
+#define PICO_HARDWARE_READY_TIMEOUT   0x00006001UL
+
+// the driver is performing a capture requested by RunStreaming or RunBlock
+// to interrupt this capture call Stop on the device first
+#define PICO_HARDWARE_CAPTURING_CALL_STOP   0x00006002UL
+
+// the number of samples is less than the minimum number allowed
+#define PICO_TOO_FEW_REQUESTED_STREAMING_SAMPLES 0x00007000UL
+
+// a streaming capture has been made but re-reading the data is not allowed
+#define PICO_STREAMING_REREAD_DATA_NOT_AVAILABLE 0x00007001UL
+
+// When requesting data only Raw and one of the following aggregation data types allowed
+//   - PICO_RATIO_MODE_AGGREGATE (Min Max),
+//     PICO_RATIO_MODE_DECIMATE,
+//     PICO_RATIO_MODE_AVERAGE and/or PICO_RATIO_MODE_SUM,
+//     PICO_RATIO_MODE_DISTRIBUTION
+//
+//	 average and sum are classed as one aggregation type
+#define PICO_STREAMING_COMBINATION_OF_RAW_DATA_AND_ONE_AGGREGATION_DATA_TYPE_ALLOWED 0x00007002UL
+
+// The time stamp per waveform segment has been reset.
+#define PICO_DEVICE_TIME_STAMP_RESET							0x01000000UL
+
+// When requesting the TriggerTimeOffset the trigger time has not been set.
+#define PICO_TRIGGER_TIME_NOT_REQUESTED						0x02000001UL
+
+// Trigger time buffer not set.
+#define PICO_TRIGGER_TIME_BUFFER_NOT_SET          0x02000002UL
+
+// The trigger time failed to be calculated.
+#define PICO_TRIGGER_TIME_FAILED_TO_CALCULATE     0x02000004UL
+
+// The trigger time failed to be calculated.
+#define PICO_TRIGGER_WITHIN_A_PRE_TRIGGER_FAILED_TO_CALCULATE 0x02000008UL
+
+// The trigger time stamp was not requested.
+#define PICO_TRIGGER_TIME_STAMP_NOT_REQUESTED			0x02000100UL
+
+// RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION cannot have a buffer set
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_DOES_NOT_REQUIRE_BUFFERS 0x02200000UL
+
+// it is not possible to set a buffer for RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION therefore
+// information is not available pertaining to samples
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_DOES_NOT_HAVE_BUFFERS 0x02200001UL
+
+// to get the trigger time use either GetTriggerInfo or GetTriggerTimeOffset api calls
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_USE_GETTRIGGERINFO 0x02200002UL
+
+
+// PICO_RATIO_MDOE_TRIGGER and RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION is not supported in streaming capture
+#define PICO_STREAMING_DOES_NOT_SUPPORT_TRIGGER_RATIO_MODES 0x02200003UL
+
+// only the PICO_TRIGGER_READ may be used to read PICO_RATIO_MODE_TRIGGER, and PICO_RATIO_MODE_TRIGGER_FOR_CALCULATION
+#define PICO_USE_THE_TRIGGER_READ 0x02200004UL
+
+// one of the PICO_DATA_READs should be used to read:
+// PICO_RATIO_MODE_RAW
+// PICO_RATIO_MODE_AGGREGATE
+// PICO_RATIO_MODE_DECIMATE
+// PICO_RATIO_MODE_AVERAGE
+#define PICO_USE_A_DATA_READ 0x02200005UL
+
+// trigger data always requires a PICO_INT16_T data type
+#define PICO_TRIGGER_READ_REQUIRES_INT16_T_DATA_TYPE 0x02200006UL
+
+// a ratio mode passed to the API call requires the number of samples to be greater than zero
+#define PICO_RATIO_MODE_REQUIRES_NUMBER_OF_SAMPLES_TO_BE_SET 0x02200007UL
+
+// Attempted to set up the signal generator with an inconsistent configuration.
+#define PICO_SIGGEN_SETTINGS_MISMATCH             0x03000010UL
+
+// The signal generator has been partially reconfigured and the new settings must be applied before it can be paused or restarted.
+#define PICO_SIGGEN_SETTINGS_CHANGED_CALL_APPLY   0x03000011UL
+
+// The wave type is not listed in enPicoWaveType.
+#define PICO_SIGGEN_WAVETYPE_NOT_SUPPORTED        0x03000012UL
+
+// The trigger type is not listed in enSigGenTrigType.
+#define PICO_SIGGEN_TRIGGERTYPE_NOT_SUPPORTED     0x03000013UL
+
+// The trigger source is not listed in enSigGenTrigSource.
+#define PICO_SIGGEN_TRIGGERSOURCE_NOT_SUPPORTED   0x03000014UL
+
+// The filter state is not listed in enPicoSigGenFilterState.
+#define PICO_SIGGEN_FILTER_STATE_NOT_SUPPORTED    0x03000015UL
+
+// The arbitrary waveform buffer is a null pointer.
+#define PICO_SIGGEN_NULL_PARAMETER                0x03000020UL
+
+// The arbitrary waveform buffer length is zero.
+#define PICO_SIGGEN_EMPTY_BUFFER_SUPPLIED         0x03000021UL
+
+// The sig gen voltage offset and peak to peak have not been set.
+#define PICO_SIGGEN_RANGE_NOT_SUPPLIED            0x03000022UL
+
+// The sig gen arbitrary waveform buffer not been set.
+#define PICO_SIGGEN_BUFFER_NOT_SUPPLIED           0x03000023UL
+
+// The sig gen frequency have not been set.
+#define PICO_SIGGEN_FREQUENCY_NOT_SUPPLIED        0x03000024UL
+
+// The sig gen sweep information has not been set.
+#define PICO_SIGGEN_SWEEP_INFO_NOT_SUPPLIED       0x03000025UL
+
+// The sig gen trigger information has not been set.
+#define PICO_SIGGEN_TRIGGER_INFO_NOT_SUPPLIED     0x03000026UL
+
+// The sig gen clock frequency have not been set.
+#define PICO_SIGGEN_CLOCK_FREQ_NOT_SUPPLIED       0x03000027UL
+
+// The sig gen arbitrary waveform buffer length is too long.
+#define PICO_SIGGEN_TOO_MANY_SAMPLES              0x03000030UL
+
+// The duty cycle value is out of range.
+#define PICO_SIGGEN_DUTYCYCLE_OUT_OF_RANGE        0x03000031UL
+
+// The number of cycles is out of range.
+#define PICO_SIGGEN_CYCLES_OUT_OF_RANGE           0x03000032UL
+
+// The pre-scaler is out of range.
+#define PICO_SIGGEN_PRESCALE_OUT_OF_RANGE         0x03000033UL
+
+// The sweep type is not listed in enPicoSweepType.
+#define PICO_SIGGEN_SWEEPTYPE_INVALID             0x03000034UL
+
+// A mismatch has occurred while checking the sweeps wave type.
+#define PICO_SIGGEN_SWEEP_WAVETYPE_MISMATCH       0x03000035UL
+
+// The sweeps or shots and trigger type are not valid when combined together.
+#define PICO_SIGGEN_INVALID_SWEEP_PARAMETERS      0x03000036UL
+
+// The sweep and prescaler are not valid when combined together.
+#define PICO_SIGGEN_SWEEP_PRESCALE_NOT_SUPPORTED  0x03000037UL
+
+// The potential applied to the AWG output exceeds the maximum voltage range of the AWG.
+#define PICO_AWG_OVER_VOLTAGE_RANGE               0x03000038UL
+
+// The reference signal cannot be locked to.
+#define PICO_NOT_LOCKED_TO_REFERENCE_FREQUENCY  0x03000039UL
+
+// (Linux only.) udev rules are incorrectly configured. The user does
+// not have read/write permissions on the device's file descriptor.
+#define PICO_PERMISSIONS_ERROR  0x03000040UL
+
+// The digital ports without analog channels are only allowed in 8-bit resolution.
+#define PICO_PORTS_WITHOUT_ANALOGUE_CHANNELS_ONLY_ALLOWED_IN_8BIT_RESOLUTION 0x03001000UL
+
+#define PICO_ANALOGUE_FRONTEND_MISSING 0x03003001UL
+#define PICO_FRONT_PANEL_MISSING 0x03003002UL
+#define PICO_ANALOGUE_FRONTEND_AND_FRONT_PANEL_MISSING 0x03003003UL
+
+// The digital board has reported an error to the driver
+#define PICO_DIGITAL_BOARD_HARDWARE_ERROR 0x03003800UL
+
+// checking if the firmware needs updating the updateRequired parameter is null
+#define PICO_FIRMWARE_UPDATE_REQUIRED_TO_USE_DEVICE_WITH_THIS_DRIVER		          0x03004000UL
+#define PICO_UPDATE_REQUIRED_NULL																				          0x03004001UL
+#define PICO_FIRMWARE_UP_TO_DATE																				          0x03004002UL
+#define PICO_FLASH_FAIL																									          0x03004003UL
+#define PICO_INTERNAL_ERROR_FIRMWARE_LENGTH_INVALID											          0x03004004UL
+#define PICO_INTERNAL_ERROR_FIRMWARE_NULL																          0x03004005UL
+#define PICO_FIRMWARE_FAILED_TO_BE_CHANGED															          0x03004006UL
+#define PICO_FIRMWARE_FAILED_TO_RELOAD																	          0x03004007UL
+#define PICO_FIRMWARE_FAILED_TO_BE_UPDATE																          0x03004008UL
+#define PICO_FIRMWARE_VERSION_OUT_OF_RANGE															          0x03004009UL
+
+#define PICO_OPTIONAL_BOOTLOADER_UPDATE_AVAILABLE_WITH_THIS_DRIVER	0x03005000UL
+#define PICO_BOOTLOADER_VERSION_NOT_AVAILABLE 0x03005001UL
+
+#define PICO_NO_APPS_AVAILABLE                                          0x03008000UL
+#define PICO_UNSUPPORTED_APP                                            0x03008001UL
+
+// the adc is powered down when trying to capture data
+#define PICO_ADC_POWERED_DOWN 0x03002000UL
+
+// An internal error has occurred and a watchdog timer has been called.
+#define PICO_WATCHDOGTIMER                        0x10000000UL
+
+// The picoipp.dll has not been found.
+#define PICO_IPP_NOT_FOUND                				0x10000001UL
+
+// A function in the picoipp.dll does not exist.
+#define PICO_IPP_NO_FUNCTION					            0x10000002UL
+
+// The Pico IPP call has failed.
+#define PICO_IPP_ERROR					                  0x10000003UL
+
+// Shadow calibration is not available on this device.
+#define PICO_SHADOW_CAL_NOT_AVAILABLE             0x10000004UL
+
+// Shadow calibration is currently disabled.
+#define PICO_SHADOW_CAL_DISABLED                  0x10000005UL
+
+// Shadow calibration error has occurred.
+#define PICO_SHADOW_CAL_ERROR                     0x10000006UL
+
+// The shadow calibration is corrupt.
+#define PICO_SHADOW_CAL_CORRUPT                   0x10000007UL
+
+// The memory on board the device has overflowed.
+#define PICO_DEVICE_MEMORY_OVERFLOW               0x10000008UL
+
+//The device Adc test failed.
+#define PICO_ADC_TEST_FAILURE                     0x10000010UL
+
+#define PICO_RESERVED_1														0x11000000UL
+
+// The PicoSource device is not ready to accept instructions.
+#define PICO_SOURCE_NOT_READY											0x20000000UL
+#define PICO_SOURCE_INVALID_BAUD_RATE							0x20000001UL
+#define PICO_SOURCE_NOT_OPENED_FOR_WRITE					0x20000002UL
+#define PICO_SOURCE_FAILED_TO_WRITE_DEVICE				0x20000003UL
+#define PICO_SOURCE_EEPROM_FAIL										0x20000004UL
+#define PICO_SOURCE_EEPROM_NOT_PRESENT 						0x20000005UL
+#define PICO_SOURCE_EEPROM_NOT_PROGRAMMED					0x20000006UL
+#define PICO_SOURCE_LIST_NOT_READY								0x20000007UL
+#define PICO_SOURCE_FTD2XX_NOT_FOUND							0x20000008UL
+#define PICO_SOURCE_FTD2XX_NO_FUNCTION						0x20000009UL
+
+typedef uint32_t PICO_STATUS;
+
+typedef enum enPicoStringValue
+{
+	PICO_SV_MEMORY,
+	PICO_SV_MEMORY_NO_OF_SEGMENTS,
+	PICO_SV_MEMORY_MAX_SAMPLES,
+
+	PICO_SV_NO_OF_CHANNELS,
+	PICO_SV_ARRAY_OF_CHANNELS,
+	PICO_SV_CHANNEL,
+	PICO_SV_CHANNEL_NAME,
+	PICO_SV_CHANNEL_RANGE,
+	PICO_SV_CHANNEL_COUPLING,
+	PICO_SV_CHANNEL_ENABLED,
+	PICO_SV_CHANNEL_ANALOGUE_OFFSET,
+	PICO_SV_CHANNEL_FILTER,
+
+	PICO_SV_TRIGGER,
+	PICO_SV_TRIGGER_AUXIO_OUTPUT_ENABLED,
+	PICO_SV_TRIGGER_AUTO_TRIGGER_MICROSECONDS,
+
+	PICO_SV_TRIGGER_PROPERTIES,
+	PICO_SV_NO_OF_TRIGGER_PROPERTIES,
+
+	PICO_SV_TRIGGER_PROPERTIES_CHANNEL,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_UPPER,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_UPPER_HYSTERESIS,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_LOWER,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_LOWER_HYSTERESIS,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_MODE,
+
+	PICO_SV_TRIGGER_ARRAY_OF_BLOCK_CONDITIONS,
+	PICO_SV_TRIGGER_NO_OF_BLOCK_CONDITIONS,
+	PICO_SV_TRIGGER_CONDITIONS,
+	PICO_SV_TRIGGER_NO_OF_CONDITIONS,
+	PICO_SV_TRIGGER_CONDITION_SOURCE,
+	PICO_SV_TRIGGER_CONDITION_STATE,
+
+	PICO_SV_TRIGGER_DIRECTION,
+	PICO_SV_TRIGGER_NO_OF_DIRECTIONS,
+	PICO_SV_TRIGGER_DIRECTION_CHANNEL,
+	PICO_SV_TRIGGER_DIRECTION_DIRECTION,
+
+	PICO_SV_TRIGGER_DELAY,
+	PICO_SV_TRIGGER_DELAY_MS,
+
+	PICO_SV_FREQUENCY_COUNTER,
+	PICO_SV_FREQUENCY_COUNTER_ENABLED,
+	PICO_SV_FREQUENCY_COUNTER_CHANNEL,
+	PICO_SV_FREQUENCY_COUNTER_RANGE,
+	PICO_SV_FREQUENCY_COUNTER_TRESHOLDMAJOR,
+	PICO_SV_FREQUENCY_COUNTER_TRESHOLDMINOR,
+
+	PICO_SV_PULSE_WIDTH_PROPERTIES,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_DIRECTION,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_LOWER,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_UPPER,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_TYPE,
+
+	PICO_SV_PULSE_WIDTH_ARRAY_OF_BLOCK_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_NO_OF_BLOCK_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_NO_OF_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_CONDITIONS_SOURCE,
+	PICO_SV_PULSE_WIDTH_CONDITIONS_STATE,
+
+	PICO_SV_SAMPLE_PROPERTIES,
+	PICO_SV_SAMPLE_PROPERTIES_PRE_TRIGGER_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_POST_TRIGGER_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_TIMEBASE,
+	PICO_SV_SAMPLE_PROPERTIES_NO_OF_CAPTURES,
+	PICO_SV_SAMPLE_PROPERTIES_RESOLUTION,
+
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_DOWN_SAMPLE_RATIO,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_DOWN_SAMPLE_RATIO_MODE,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_REQUERSTED_NO_OF_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_SEGMENT_INDEX_FROM,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_SEGMENT_INDEX_TO,
+
+	PICO_SV_SIGNAL_GENERATOR,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_WAVE_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_START_FREQUENCY,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_STOP_FREQUENCY,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_INCREMENT,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_DWELL_TIME,
+	PICO_SV_SIGNAL_GENERATOR_AWG,
+	PICO_SV_SIGNAL_GENERATOR_AWG_START_DELTA_PHASE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_STOP_DELTA_PHASE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_DELTA_PHASE_INCREMENT,
+	PICO_SV_SIGNAL_GENERATOR_AWG_DWELL_COUNT,
+	PICO_SV_SIGNAL_GENERATOR_AWG_INDEX_MODE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_WAVEFORM_SIZE,
+	PICO_SV_SIGNAL_GENERATOR_ARRAY_OF_AWG_WAVEFORM_VALUES,
+	PICO_SV_SIGNAL_GENERATOR_OFFSET_VOLTAGE,
+	PICO_SV_SIGNAL_GENERATOR_PK_TO_PK,
+	PICO_SV_SIGNAL_GENERATOR_OPERATION,
+	PICO_SV_SIGNAL_GENERATOR_SHOTS,
+	PICO_SV_SIGNAL_GENERATOR_SWEEPS,
+	PICO_SV_SIGNAL_GENERATOR_SWEEP_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_TRIGGER_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_TRIGGER_SOURCE,
+	PICO_SV_SIGNAL_GENERATOR_EXT_IN_THRESHOLD,
+
+	PICO_SV_ETS,
+	PICO_SV_ETS_STATE,
+	PICO_SV_ETS_CYCLE,
+	PICO_SV_ETS_INTERLEAVE,
+	PICO_SV_ETS_SAMPLE_TIME_PICOSECONDS
+
+} PICO_STRING_VALUE;
+
+#endif

+ 1286 - 0
pico-tcp-service/pico-tcp-client/libps4000a/ps4000aApi.h

@@ -0,0 +1,1286 @@
+/****************************************************************************
+ *
+ * Filename:    ps4000aApi.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *	PicoScope 4444 and 4824 PC Oscilloscopes.
+ *
+ * Copyright � 2013 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS4000AAPI_H__
+#define __PS4000AAPI_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+#include "../inc/PicoCallback.h"
+#include "../inc/PicoConnectProbes.h"
+#include "../inc/PicoVersion.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+	#define PREF0 extern "C"
+#else
+	#define PREF0
+#endif
+
+#ifdef WIN32
+/*	If you are dynamically linking ps4000a.dll into your project #define DYNLINK here
+ */
+#ifdef DYNLINK
+  #define PREF1 typedef
+	#define PREF2
+	#define PREF3(x) (__stdcall *x)
+#else
+  #define PREF1
+	#ifdef _USRDLL
+		#define PREF2 __declspec(dllexport) __stdcall
+	#else
+		#define PREF2 __declspec(dllimport) __stdcall
+	#endif
+  #define PREF3(x) x
+#endif
+	#define PREF4 __stdcall
+#else
+
+	/* Define a 64-bit integer type */
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+	#define PREF4
+#endif
+
+#define PS4000A_EXT_MAX_VALUE  32767
+#define PS4000A_EXT_MIN_VALUE -32767
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+#define MAX_DELAY_COUNT 8388607L
+
+#define PS4000A_MAX_SIG_GEN_BUFFER_SIZE 16384
+
+#define PS4000A_MIN_SIG_GEN_BUFFER_SIZE 10
+#define PS4000A_MIN_DWELL_COUNT				10
+#define PS4000A_MAX_SWEEPS_SHOTS				((1 << 30) - 1)
+#define	PS4000A_AWG_DAC_FREQUENCY							80e6
+#define	PS4000A_AWG_PHASE_ACCUMULATOR  4294967296.0
+
+#define PS4000A_MAX_ANALOGUE_OFFSET_50MV_200MV	 0.250f
+#define PS4000A_MIN_ANALOGUE_OFFSET_50MV_200MV	-0.250f
+#define PS4000A_MAX_ANALOGUE_OFFSET_500MV_2V		 2.500f
+#define PS4000A_MIN_ANALOGUE_OFFSET_500MV_2V		-2.500f
+#define PS4000A_MAX_ANALOGUE_OFFSET_5V_20V			 20.f
+#define PS4000A_MIN_ANALOGUE_OFFSET_5V_20V			-20.f
+#define PS4000A_MAX_ANALOGUE_OFFSET_10V_50V      25.f
+#define PS4000A_MIN_ANALOGUE_OFFSET_10V_50V     -25.f
+
+
+typedef enum enPS4000ADeviceResolution
+{
+	PS4000A_DR_8BIT,
+	PS4000A_DR_12BIT,
+	PS4000A_DR_14BIT,
+	PS4000A_DR_15BIT,
+	PS4000A_DR_16BIT,
+} PS4000A_DEVICE_RESOLUTION;
+
+typedef enum enPS4000AExtraOperations
+{
+	PS4000A_ES_OFF,
+	PS4000A_WHITENOISE,
+	PS4000A_PRBS // Pseudo-Random Bit Stream
+} PS4000A_EXTRA_OPERATIONS;
+
+typedef enum	enPS4000ABandwidthLimiterFlags
+{
+	PS4000A_BW_FULL_FLAG = (1 << 0),
+	PS4000A_BW_20KHZ_FLAG = (1 << 1),
+	PS4000A_BW_100KHZ_FLAG = (1 << 2), //( default when current clamp detected: can be changed)
+	PS4000A_BW_1MHZ_FLAG  = (1 << 3)  //( default for 14 bits: can be changed)
+} PS4000A_BANDWIDTH_LIMITER_FLAGS;
+
+typedef enum	enPS4000ABandwidthLimiter
+{
+	PS4000A_BW_FULL,
+	PS4000A_BW_20KHZ,
+	PS4000A_BW_100KHZ, //( default when current clamp detected: can be changed)
+	PS4000A_BW_1MHZ
+} PS4000A_BANDWIDTH_LIMITER;
+
+typedef enum enPS4000ACoupling
+{
+	PS4000A_AC,
+	PS4000A_DC
+} PS4000A_COUPLING;
+
+typedef enum enPS4000AChannel
+{
+	PS4000A_CHANNEL_A,
+	PS4000A_CHANNEL_B,
+	PS4000A_CHANNEL_C,
+	PS4000A_CHANNEL_D,
+	PS4000A_MAX_4_CHANNELS,
+	PS4000A_CHANNEL_E = PS4000A_MAX_4_CHANNELS,
+	PS4000A_CHANNEL_F,
+	PS4000A_CHANNEL_G,
+	PS4000A_CHANNEL_H,
+	PS4000A_EXTERNAL,
+	PS4000A_MAX_CHANNELS = PS4000A_EXTERNAL,
+	PS4000A_TRIGGER_AUX,
+	PS4000A_MAX_TRIGGER_SOURCES,
+	PS4000A_PULSE_WIDTH_SOURCE = 0x10000000
+}	PS4000A_CHANNEL;
+
+
+
+typedef enum enPS4000AChannelBufferIndex
+{
+	PS4000A_CHANNEL_A_MAX,
+	PS4000A_CHANNEL_A_MIN,
+	PS4000A_CHANNEL_B_MAX,
+	PS4000A_CHANNEL_B_MIN,
+	PS4000A_CHANNEL_C_MAX,
+	PS4000A_CHANNEL_C_MIN,
+	PS4000A_CHANNEL_D_MAX,
+	PS4000A_CHANNEL_D_MIN,
+	PS4000A_CHANNEL_E_MAX,
+	PS4000A_CHANNEL_E_MIN,
+	PS4000A_CHANNEL_F_MAX,
+	PS4000A_CHANNEL_F_MIN,
+	PS4000A_CHANNEL_G_MAX,
+	PS4000A_CHANNEL_G_MIN,
+	PS4000A_CHANNEL_H_MAX,
+	PS4000A_CHANNEL_H_MIN,
+	PS4000A_MAX_CHANNEL_BUFFERS
+} PS4000A_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS4000ARange
+{
+	PS4000A_10MV,
+	PS4000A_20MV,
+	PS4000A_50MV,
+	PS4000A_100MV,
+	PS4000A_200MV,
+	PS4000A_500MV,
+	PS4000A_1V,
+	PS4000A_2V,
+	PS4000A_5V,
+	PS4000A_10V,
+	PS4000A_20V,
+	PS4000A_50V,
+	PS4000A_100V,
+	PS4000A_200V,
+	PS4000A_MAX_RANGES
+}	PS4000A_RANGE;
+
+typedef enum enPS4000AResistanceRange
+{
+	PS4000A_RESISTANCE_315K = 0x00000200,
+	PS4000A_RESISTANCE_1100K,
+	PS4000A_RESISTANCE_10M,
+	PS4000A_MAX_RESISTANCE_RANGES = (PS4000A_RESISTANCE_10M + 1) - PS4000A_RESISTANCE_315K,
+	PS4000A_RESISTANCE_ADCV = 0x10000000
+}	PS4000A_RESISTANCE_RANGE;
+
+typedef enum enPS4000AEtsMode
+  {
+  PS4000A_ETS_OFF,             // ETS disabled
+  PS4000A_ETS_FAST,            // Return ready as soon as requested no of interleaves is available
+  PS4000A_ETS_SLOW,            // Return ready every time a new set of no_of_cycles is collected
+  PS4000A_ETS_MODES_MAX
+  }	PS4000A_ETS_MODE;
+
+typedef enum enPS4000ATimeUnits
+  {
+  PS4000A_FS,
+  PS4000A_PS,
+  PS4000A_NS,
+  PS4000A_US,
+  PS4000A_MS,
+  PS4000A_S,
+  PS4000A_MAX_TIME_UNITS,
+  }	PS4000A_TIME_UNITS;
+
+typedef enum enPS4000ASweepType
+{
+	PS4000A_UP,
+	PS4000A_DOWN,
+	PS4000A_UPDOWN,
+	PS4000A_DOWNUP,
+	PS4000A_MAX_SWEEP_TYPES
+} PS4000A_SWEEP_TYPE;
+
+typedef enum enPS4000AWaveType
+{
+	PS4000A_SINE,
+	PS4000A_SQUARE,
+	PS4000A_TRIANGLE,
+	PS4000A_RAMP_UP,
+	PS4000A_RAMP_DOWN,
+	PS4000A_SINC,
+	PS4000A_GAUSSIAN,
+	PS4000A_HALF_SINE,
+	PS4000A_DC_VOLTAGE,
+	PS4000A_WHITE_NOISE,
+	PS4000A_MAX_WAVE_TYPES
+} PS4000A_WAVE_TYPE;
+
+typedef enum enPS4000APinStates
+{
+	PS4000A_CAL_PINS_OFF,
+	PS4000A_GND_SIGNAL,
+	PS4000A_SIGNAL_SIGNAL
+} PS4000A_PIN_STATES;
+
+#define PS4000A_SINE_MAX_FREQUENCY				1000000.f
+#define PS4000A_SQUARE_MAX_FREQUENCY			1000000.f
+#define PS4000A_TRIANGLE_MAX_FREQUENCY		1000000.f
+#define PS4000A_SINC_MAX_FREQUENCY				1000000.f
+#define PS4000A_RAMP_MAX_FREQUENCY				1000000.f
+#define PS4000A_HALF_SINE_MAX_FREQUENCY	1000000.f
+#define PS4000A_GAUSSIAN_MAX_FREQUENCY		1000000.f
+#define PS4000A_MIN_FREQUENCY									 0.03f
+
+typedef enum enPS4000AChannelLed
+{
+	PS4000A_CHANNEL_LED_OFF,
+	PS4000A_CHANNEL_LED_RED,
+	PS4000A_CHANNEL_LED_GREEN
+} PS4000A_CHANNEL_LED;
+
+typedef enum enPS4000AProbeLedPosition
+{
+	PS4000A_UPPER_LEFT_LED = 1,
+	PS4000A_LOWER_LEFT_LED = 2,
+	PS4000A_UPPER_RIGHT_LED = 4,
+	PS4000A_LOWER_RIGHT_LED = 8,
+
+	PS4000A_RIGHT_LEDS = PS4000A_UPPER_RIGHT_LED | PS4000A_LOWER_RIGHT_LED,
+	PS4000A_LEFT_LEDS = PS4000A_UPPER_LEFT_LED | PS4000A_LOWER_LEFT_LED,
+
+	PS4000A_UPPER_LEDS = PS4000A_UPPER_RIGHT_LED | PS4000A_UPPER_LEFT_LED,
+	PS4000A_LOWER_LEDS = PS4000A_LOWER_RIGHT_LED | PS4000A_LOWER_LEFT_LED,
+
+	PS4000A_ALL_LEDS = PS4000A_UPPER_LEFT_LED | PS4000A_LOWER_LEFT_LED | PS4000A_UPPER_RIGHT_LED | PS4000A_LOWER_RIGHT_LED
+} PS4000A_PROBE_LED_POSITION;
+
+typedef enum enPS4000AMetaType
+{
+	PS4000A_MT_UNIT_INFO,
+	PS4000A_MT_DEVICE_CAPABILITY,
+	PS4000A_MT_DEVICE_SETTINGS,
+	PS4000A_MT_SIGNAL_GENERATOR_SETTINGS
+} PS4000A_META_TYPE;
+
+typedef enum enPS4000AMetaOperation
+{
+	PS4000A_MO_READ,
+	PS4000A_MO_WRITE
+} PS4000A_META_OPERATION;
+
+typedef enum enPS4000AMetaFormat
+{
+	PS4000A_MF_COMMA_SEPARATED,
+	PS4000A_MF_XML
+} PS4000A_META_FORMAT;
+
+typedef enum enPS4000ASigGenTrigType
+{
+	PS4000A_SIGGEN_RISING,
+	PS4000A_SIGGEN_FALLING,
+	PS4000A_SIGGEN_GATE_HIGH,
+	PS4000A_SIGGEN_GATE_LOW
+} PS4000A_SIGGEN_TRIG_TYPE;
+
+typedef enum enPS4000ASigGenTrigSource
+{
+	PS4000A_SIGGEN_NONE,
+	PS4000A_SIGGEN_SCOPE_TRIG,
+	PS4000A_SIGGEN_AUX_IN,
+	PS4000A_SIGGEN_EXT_IN,
+	PS4000A_SIGGEN_SOFT_TRIG
+} PS4000A_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPS4000AIndexMode
+{
+	PS4000A_SINGLE,
+	PS4000A_DUAL,
+	PS4000A_QUAD,
+	PS4000A_MAX_INDEX_MODES
+} PS4000A_INDEX_MODE;
+
+typedef enum enPS4000AThresholdMode
+{
+	PS4000A_LEVEL,
+	PS4000A_WINDOW
+} PS4000A_THRESHOLD_MODE;
+
+typedef enum enPS4000AThresholdDirection
+{
+	PS4000A_ABOVE, //using upper threshold
+	PS4000A_BELOW, //using upper threshold
+	PS4000A_RISING, // using upper threshold
+	PS4000A_FALLING, // using upper threshold
+	PS4000A_RISING_OR_FALLING, // using both threshold
+	PS4000A_ABOVE_LOWER, // using lower threshold
+	PS4000A_BELOW_LOWER, // using lower threshold
+	PS4000A_RISING_LOWER,			 // using lower threshold
+	PS4000A_FALLING_LOWER,		 // using lower threshold
+
+	// Windowing using both thresholds
+	PS4000A_INSIDE = PS4000A_ABOVE,
+	PS4000A_OUTSIDE = PS4000A_BELOW,
+	PS4000A_ENTER = PS4000A_RISING,
+	PS4000A_EXIT = PS4000A_FALLING,
+	PS4000A_ENTER_OR_EXIT = PS4000A_RISING_OR_FALLING,
+	PS4000A_POSITIVE_RUNT = 9,
+  PS4000A_NEGATIVE_RUNT,
+
+	// no trigger set
+  PS4000A_NONE = PS4000A_RISING
+} PS4000A_THRESHOLD_DIRECTION;
+
+
+typedef enum enPS4000ATriggerState
+{
+  PS4000A_CONDITION_DONT_CARE,
+  PS4000A_CONDITION_TRUE,
+  PS4000A_CONDITION_FALSE,
+	PS4000A_CONDITION_MAX
+} PS4000A_TRIGGER_STATE;
+
+typedef enum enPS4000ASensorState
+{
+	PS4000A_CONNECT_STATE_FLOATING,
+	PS4000A_SENSOR_STATE_CONNECTED
+} PS4000A_SENSOR_STATE;
+
+typedef enum enPS4000AFrequencyCounterRange
+{
+  PS4000A_FC_2K,
+  PS4000A_FC_20K,
+  PS4000A_FC_20,
+  PS4000A_FC_200,
+  PS4000A_FC_MAX
+}PS4000A_FREQUENCY_COUNTER_RANGE;
+
+typedef enum enPS4000AChannelFlags
+{
+	PS4000A_CHANNEL_A_FLAGS = 1,
+	PS4000A_CHANNEL_B_FLAGS = 2,
+	PS4000A_CHANNEL_C_FLAGS = 4,
+	PS4000A_CHANNEL_D_FLAGS = 8,
+	PS4000A_CHANNEL_E_FLAGS = 16,
+	PS4000A_CHANNEL_F_FLAGS = 32,
+	PS4000A_CHANNEL_G_FLAGS = 64,
+	PS4000A_CHANNEL_H_FLAGS = 128,
+}	PS4000A_CHANNEL_FLAGS;
+
+#pragma pack(push,1)
+typedef struct tPS4000AChannelLedSetting
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_CHANNEL_LED state;
+} PS4000A_CHANNEL_LED_SETTING;
+
+typedef struct ps4000aProbeLedColour
+{
+	uint8_t red;
+	uint8_t green;
+	uint8_t blue;
+} PS4000A_PROBE_LED_COLOUR;
+
+typedef struct tPS4000AProbeChannelLedSetting
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_PROBE_LED_POSITION position;
+	PS4000A_PROBE_LED_COLOUR rgb;
+} PS4000A_PROBE_CHANNEL_LED_SETTING;
+
+typedef struct tPS4000ADirection
+{
+	PS4000A_CHANNEL							channel;
+	PS4000A_THRESHOLD_DIRECTION direction;
+} PS4000A_DIRECTION;
+
+
+typedef struct tPS4000ACondition
+{
+	PS4000A_CHANNEL   		source;
+  PS4000A_TRIGGER_STATE condition;
+} PS4000A_CONDITION;
+
+typedef enum enPS4000AConditionsInfo
+{
+	PS4000A_CLEAR = 0x00000001,
+  PS4000A_ADD = 0x00000002
+} PS4000A_CONDITIONS_INFO;
+
+typedef struct tPS4000ATriggerChannelProperties
+{
+  int16_t										thresholdUpper;
+	uint16_t					thresholdUpperHysteresis;
+  int16_t										thresholdLower;
+	uint16_t					thresholdLowerHysteresis;
+	PS4000A_CHANNEL					channel;
+  PS4000A_THRESHOLD_MODE	thresholdMode;
+} PS4000A_TRIGGER_CHANNEL_PROPERTIES;
+
+typedef struct tPS4000AConnectDetect
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_SENSOR_STATE state;
+} PS4000A_CONNECT_DETECT;
+
+typedef struct tPS4000AUserProbeInteractions
+{
+	uint16_t connected;
+
+	PS4000A_CHANNEL channel;
+	uint16_t enabled;
+
+	PicoConnectProbe probeName;
+
+	uint8_t requiresPower_;
+	uint8_t isPowered_;
+
+	PICO_STATUS status_;
+
+	PICO_CONNECT_PROBE_RANGE probeOff;
+
+	PICO_CONNECT_PROBE_RANGE rangeFirst_;
+	PICO_CONNECT_PROBE_RANGE rangeLast_;
+	PICO_CONNECT_PROBE_RANGE rangeCurrent_;
+
+	PS4000A_COUPLING couplingFirst_;
+	PS4000A_COUPLING couplingLast_;
+	PS4000A_COUPLING couplingCurrent_;
+
+	PS4000A_BANDWIDTH_LIMITER_FLAGS filterFlags_;
+	PS4000A_BANDWIDTH_LIMITER_FLAGS filterCurrent_;
+
+	PS4000A_BANDWIDTH_LIMITER defaultFilter_;
+} PS4000A_USER_PROBE_INTERACTIONS;
+#pragma pack(pop)
+
+
+typedef enum enPS4000ARatioMode
+{
+	PS4000A_RATIO_MODE_NONE = 0,
+	PS4000A_RATIO_MODE_AGGREGATE = 1,
+	PS4000A_RATIO_MODE_DECIMATE = 2,
+	PS4000A_RATIO_MODE_AVERAGE = 4,
+	PS4000A_RATIO_MODE_DISTRIBUTION = 8
+} PS4000A_RATIO_MODE;
+
+typedef enum enPS4000APulseWidthType
+{
+	PS4000A_PW_TYPE_NONE,
+  PS4000A_PW_TYPE_LESS_THAN,
+	PS4000A_PW_TYPE_GREATER_THAN,
+	PS4000A_PW_TYPE_IN_RANGE,
+	PS4000A_PW_TYPE_OUT_OF_RANGE
+} PS4000A_PULSE_WIDTH_TYPE;
+
+typedef enum enPS4000AChannelInfo
+{
+	PS4000A_CI_RANGES,
+	PS4000A_CI_RESISTANCES,
+} PS4000A_CHANNEL_INFO;
+
+typedef void (PREF4 *ps4000aBlockReady)
+	(
+		int16_t											handle,
+		PICO_STATUS								status,
+		void										*	pParameter
+	);
+
+typedef void (PREF4 *ps4000aStreamingReady)
+	(
+		int16_t    									handle,
+		int32_t     									noOfSamples,
+		uint32_t							startIndex,
+		int16_t    									overflow,
+		uint32_t							triggerAt,
+		int16_t    									triggered,
+		int16_t    									autoStop,
+		void										*	pParameter
+	);
+
+
+typedef void (PREF4 *ps4000aDataReady)
+	(
+		int16_t    									handle,
+		PICO_STATUS								status,
+		uint32_t     				noOfSamples,
+		int16_t    									overflow,
+		void										*	pParameter
+	);
+
+
+typedef void (PREF4 *ps4000aProbeInteractions)
+	(
+		int16_t    												handle,
+		PICO_STATUS												status,
+		PS4000A_USER_PROBE_INTERACTIONS * probes,
+		uint32_t													nProbes
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aOpenUnitWithResolution)
+(
+	int16_t											* handle,
+	int8_t											* serial,
+	PS4000A_DEVICE_RESOLUTION			resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnit)
+  (
+	  int16_t											* handle,
+		int8_t											* serial
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aOpenUnitAsyncWithResolution)
+(
+	int16_t											* status,
+	int8_t											* serial,
+	PS4000A_DEVICE_RESOLUTION			resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnitAsync)
+  (
+	  int16_t											* status,
+		int8_t											* serial
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnitProgress)
+	(
+	  int16_t 										* handle,
+	  int16_t 										* progressPercent,
+	  int16_t 										* complete
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetUnitInfo)
+ 	(
+	  int16_t     								  handle,
+	  int8_t      								* string,
+	  int16_t     								  stringLength,
+	  int16_t     								* requiredSize,
+	  PICO_INFO 								  info
+	);
+
+// This function retrieves information about the accessory (e.g. probe) attached to the specified channel.
+// Note: you must set a probe interaction callback to be able to retrieve probe information.
+//
+// parameters:
+// handle: identifies the device to which the accessory is attached.
+// channel: identifies the channel to which the accessory is attached. If no accessory is connected to this channel, an error will result.
+// string: on exit, the accessory information string selected specified by the info argument. If string is NULL, only requiredSize is returned.
+// stringLength: the maximum number of 8-bit integers (int8_t) that may be written to string.
+// requiredSize: on exit, the required length of the string array.
+// info: a number specifying what information is required. Note that unlike ps6000aGetUnitInfo, only PICO_BATCH_AND_SERIAL and PICO_CAL_DATE are valid for accessories.
+//
+// return:
+// PICO_OK
+// PICO_INVALID_HANDLE (handle isn't that of an open PicoScope device.)
+// PICO_PROBE_COLLECTION_NOT_STARTED (handle hasn't got a probe interaction callback set).
+// PICO_INVALID_CHANNEL (channel doesn't map to a channel on the device with handle.)
+// PICO_NULL_PARAMETER (requiredSize is NULL.)
+// PICO_INVALID_INFO (info is an invalid value for the attached accessory.)
+// PICO_INFO_UNAVAILABLE (no accessory is connected, or the connected accessory does not support any info.)
+// PICO_DRIVER_FUNCTION (another thread is already calling a driver function.)
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetAccessoryInfo)
+  (
+	  int16_t     								  handle,
+	  PS4000A_CHANNEL							  channel,
+	  int8_t											* string,
+	  int16_t     								  stringLength,
+	  int16_t											* requiredSize,
+	  PICO_INFO 								  info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aFlashLed)
+	(
+	  int16_t 											handle,
+		int16_t 											start
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetChannelLed)
+	(
+	int16_t 												handle,
+	PS4000A_CHANNEL_LED_SETTING		*	ledStates,
+	uint16_t												nLedStates
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsLedFlashing)
+	(
+	  int16_t 										  handle,
+		int16_t 										* status
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aCloseUnit)
+	(
+	  int16_t												handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMemorySegments)
+	(
+	  int16_t												handle,
+		uint32_t								nSegments,
+		int32_t											* nMaxSamples
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetChannel)
+ 	(
+	  int16_t											handle,
+		PS4000A_CHANNEL						channel,
+	  int16_t											enabled,
+	  PS4000A_COUPLING					type,
+		PICO_CONNECT_PROBE_RANGE				range,
+		float											analogOffset
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetBandwidthFilter)
+ 	(
+	  int16_t												handle,
+	  PS4000A_CHANNEL							channel,
+	  PS4000A_BANDWIDTH_LIMITER		bandwidth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aApplyResistanceScaling)
+	(
+	int16_t											handle,
+	PS4000A_CHANNEL							channel,
+	PICO_CONNECT_PROBE_RANGE					range,
+	int16_t										* bufferMax,
+	int16_t										* bufferMin,
+	uint32_t										buffertLth,
+	int16_t										* overflow
+	);
+
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTimebase)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   int32_t											* timeIntervalNanoseconds,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTimebase2)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   float										* timeIntervalNanoseconds,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSigGenArbitrary)
+	(
+	 	int16_t												handle,
+	 	int32_t												offsetVoltage,
+	 	uint32_t								pkToPk,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+	 	int16_t											*	arbitraryWaveform,
+	 	int32_t												arbitraryWaveformSize,
+		PS4000A_SWEEP_TYPE					sweepType,
+		PS4000A_EXTRA_OPERATIONS		operation,
+		PS4000A_INDEX_MODE					indexMode,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetSigGenBuiltIn)
+	(
+		int16_t												handle,
+		int32_t												offsetVoltage,
+		uint32_t								pkToPk,
+		PS4000A_WAVE_TYPE						waveType,
+		double											startFrequency,
+		double											stopFrequency,
+		double											increment,
+		double											dwellTime,
+		PS4000A_SWEEP_TYPE					sweepType,
+		PS4000A_EXTRA_OPERATIONS		operation,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+		);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSigGenPropertiesArbitrary)
+	(
+	 	int16_t												handle,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+		PS4000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetSigGenPropertiesBuiltIn)
+	(
+		int16_t												handle,
+		double											startFrequency,
+		double											stopFrequency,
+		double											increment,
+		double											dwellTime,
+		PS4000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSigGenFrequencyToPhase)
+	(
+		int16_t												handle,
+		double												frequency,
+		PS4000A_INDEX_MODE						indexMode,
+		uint32_t											bufferLength,
+		uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSigGenSoftwareControl)
+	(
+		int16_t												handle,
+		int16_t												state
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEts)
+  (
+		int16_t												handle,
+		PS4000A_ETS_MODE						mode,
+		int16_t												etsCycles,
+		int16_t												etsInterleave,
+		int32_t											* sampleTimePicoseconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelProperties)
+	(
+		int16_t																				handle,
+		PS4000A_TRIGGER_CHANNEL_PROPERTIES			 *	channelProperties,
+		int16_t																				nChannelProperties,
+		int16_t																				auxOutputEnable,
+		int32_t																				autoTriggerMilliseconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelConditions)
+	(
+		int16_t													handle,
+		PS4000A_CONDITION					*		conditions,
+		int16_t													nConditions,
+		PS4000A_CONDITIONS_INFO				info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelDirections)
+	(
+		int16_t													handle,
+		PS4000A_DIRECTION					*		directions,
+		int16_t													nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSimpleTrigger)
+	(
+		int16_t												handle,
+		int16_t												enable,
+		PS4000A_CHANNEL							source,
+		int16_t												threshold,
+		PS4000A_THRESHOLD_DIRECTION direction,
+		uint32_t								delay,
+		int16_t												autoTrigger_ms
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerDelay)
+	(
+		int16_t									handle,
+		uint32_t					delay
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetPulseWidthQualifierProperties)
+	(
+		int16_t														handle,
+		PS4000A_THRESHOLD_DIRECTION			direction,
+		uint32_t										lower,
+		uint32_t										upper,
+		PS4000A_PULSE_WIDTH_TYPE				type
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetPulseWidthQualifierConditions)
+	(
+		int16_t												handle,
+		PS4000A_CONDITION					*	conditions,
+		int16_t												nConditions,
+		PS4000A_CONDITIONS_INFO			info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsTriggerOrPulseWidthQualifierEnabled)
+	(
+		int16_t 								handle,
+		int16_t 							* triggerEnabled,
+		int16_t 							* pulseWidthQualifierEnabled
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTriggerTimeOffset)
+	(
+		int16_t									handle,
+		uint32_t 			* timeUpper,
+		uint32_t 			* timeLower,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					segmentIndex
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTriggerTimeOffset64)
+	(
+		int16_t									handle,
+		int64_t							* time,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t				segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesTriggerTimeOffsetBulk)
+	(
+	  int16_t									handle,
+		uint32_t				*	timesUpper,
+		uint32_t				* timesLower,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					fromSegmentIndex,
+		uint32_t					toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesTriggerTimeOffsetBulk64)
+	(
+	  int16_t									handle,
+		int64_t							*	times,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					fromSegmentIndex,
+		uint32_t					toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetDataBuffers)
+(
+   int16_t									handle,
+	 PS4000A_CHANNEL 				channel,
+	 int16_t								*	bufferMax,
+	 int16_t								*	bufferMin,
+   int32_t										bufferLth,
+	 uint32_t					segmentIndex,
+	 PS4000A_RATIO_MODE			mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetDataBuffer)
+(
+   int16_t								 handle,
+	 PS4000A_CHANNEL 			 channel,
+	 int16_t							*  buffer,
+   int32_t									 bufferLth,
+	 uint32_t				 segmentIndex,
+	 PS4000A_RATIO_MODE		 mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEtsTimeBuffer)
+(
+   int16_t									handle,
+	 int64_t *							buffer,
+	 int32_t										bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEtsTimeBuffers)
+(
+   int16_t									handle,
+	 uint32_t				* timeUpper,
+	 uint32_t				* timeLower,
+	 int32_t										bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsReady)
+	(
+		int16_t handle,
+		int16_t * ready
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aRunBlock)
+	(
+		int16_t									handle,
+		int32_t									noOfPreTriggerSamples,
+		int32_t									noOfPostTriggerSamples,
+		uint32_t					timebase,
+		int32_t								* timeIndisposedMs,
+		uint32_t					segmentIndex,
+		ps4000aBlockReady			lpReady,
+		void								* pParameter
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aRunStreaming)
+  (
+	  int16_t									handle,
+		uint32_t				* sampleInterval,
+		PS4000A_TIME_UNITS		sampleIntervalTimeUnits,
+	  uint32_t					maxPreTriggerSamples,
+	  uint32_t					maxPostTriggerSamples,
+		int16_t									autoStop,
+		uint32_t					downSampleRatio,
+		PS4000A_RATIO_MODE		downSampleRatioMode,
+    uint32_t					overviewBufferSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetStreamingLatestValues)
+  (
+    int16_t									handle,
+    ps4000aStreamingReady	lpPs4000aReady,
+		void								* pParameter
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aNoOfStreamingValues)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfValues
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetMaxDownSampleRatio)
+	(
+	  int16_t								handle,
+		uint32_t 			noOfUnaggregatedSamples,
+		uint32_t 		* maxDownSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValues)
+	(
+	  int16_t								handle,
+		uint32_t 			startIndex,
+	  uint32_t			*	noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex,
+		int16_t							* overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesAsync)
+	(
+	  int16_t								handle,
+		uint32_t				startIndex,
+	  uint32_t				noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex,
+	  void							*	lpDataReady,
+		void							*	pParameter
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesBulk)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfSamples,
+		uint32_t				fromSegmentIndex,
+		uint32_t				toSegmentIndex,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE 	downSampleRatioMode,
+		int16_t							* overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesOverlapped)
+	(
+	  int16_t										handle,
+	  uint32_t			 			startIndex,
+	  uint32_t					*	noOfSamples,
+	  uint32_t						downSampleRatio,
+	  PS4000A_RATIO_MODE			downSampleRatioMode,
+		uint32_t						segmentIndex,
+	  int16_t									* overflow
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesOverlappedBulk)
+	(
+	  int16_t									handle,
+		uint32_t					startIndex,
+  	uint32_t 	 		*	noOfSamples,
+	  uint32_t					downSampleRatio,
+	  PS4000A_RATIO_MODE		downSampleRatioMode,
+	  uint32_t					fromSegmentIndex,
+	  uint32_t					toSegmentIndex,
+	  int16_t								*	overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aEnumerateUnits)
+	(
+	int16_t * count,
+	int8_t * serials,
+	int16_t * serialLth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetChannelInformation)
+	(
+	int16_t										handle,
+	PS4000A_CHANNEL_INFO		info,
+	int32_t											probe,
+	int32_t										* ranges,
+	int32_t										* length,
+	int32_t											channels);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aConnectDetect)
+	(
+	int16_t		handle,
+	PS4000A_CONNECT_DETECT * sensor,
+	int16_t  nSensors
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeInteractionCallback)
+ (
+	int16_t		handle,
+	ps4000aProbeInteractions callback
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aCalibrateProbe)
+(
+	int16_t	handle,
+	PS4000A_CHANNEL channel,
+	int16_t * checkCalibrationRequired
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeLedColour)
+(
+	int16_t		handle,
+	PS4000A_PROBE_CHANNEL_LED_SETTING * settings,
+	uint16_t nSettings
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aRegisterProbeLedColour)
+(
+	int16_t		handle,
+	PICO_CONNECT_PROBE probe,
+	PS4000A_PROBE_CHANNEL_LED_SETTING * settings,
+	uint16_t nSettings
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeLedDefaults)
+  (
+    int16_t handle,
+    int16_t enabled
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMaximumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMinimumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetAnalogueOffset)
+	(
+	int16_t							handle,
+	PICO_CONNECT_PROBE_RANGE	range,
+	PS4000A_COUPLING		coupling,
+	float							* maximumOffset,
+	float							* minimumOffset
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetMaxSegments)
+	(
+	int16_t						handle,
+	uint32_t * maxSegments
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aChangePowerSource)
+	(
+	int16_t				handle,
+  PICO_STATUS powerState
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aCurrentPowerSource)
+	(
+	int16_t		handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aStop)
+	(
+	  int16_t handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aPingUnit)
+	(
+	  int16_t handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetNoOfCaptures)
+	(
+	int16_t					handle,
+	uint32_t nCaptures
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetNoOfCaptures)
+  (
+    int16_t                handle,
+    uint32_t               * nCaptures
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetNoOfProcessedCaptures)
+  (
+    int16_t                handle,
+    uint32_t               * nProcessedCaptures
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aDeviceMetaData)
+	(
+	int16_t										handle,
+	int8_t									*	settings,
+	int32_t									*	nSettingsLength,
+	PS4000A_META_TYPE					type,
+	PS4000A_META_OPERATION		operation,
+	PS4000A_META_FORMAT				format
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetString)
+	(
+	int16_t										handle,
+	PICO_STRING_VALUE					stringValue,
+	int8_t									*	string,
+	int32_t									*	stringLength
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetCommonModeOverflow)
+	(
+	int16_t			handle,
+	uint16_t	*	overflow
+	);
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetFrequencyCounter)
+(
+    int16_t                                handle,
+    PS4000A_CHANNEL                        channel,
+    int16_t                                enabled,
+    PS4000A_FREQUENCY_COUNTER_RANGE        range,
+    int16_t                                thresholdMajor,
+    int16_t                                thresholdMinor
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetDeviceResolution)
+(
+  int16_t                          handle,
+  PS4000A_DEVICE_RESOLUTION        resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetDeviceResolution)
+(
+	int16_t                      handle,
+	PS4000A_DEVICE_RESOLUTION    * resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetCalibrationPins)
+(
+	int16_t               handle,
+	PS4000A_PIN_STATES		pinStates,
+	PS4000A_WAVE_TYPE			waveType,
+	double								frequency,
+	uint32_t							amplitude,
+	uint32_t							offset
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aNearestSampleIntervalStateless)
+(
+	int16_t                        handle,
+	PS4000A_CHANNEL_FLAGS          enabledChannelOrPortFlags,
+	double                         timeIntervalRequested,
+	PS4000A_DEVICE_RESOLUTION      resolution,
+	uint16_t                       useEts,
+	uint32_t                       * timebase,
+	double                         * timeIntervalAvailable
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetMinimumTimebaseStateless)
+(
+	int16_t                        handle,
+	PS4000A_CHANNEL_FLAGS          enabledChannelOrPortFlags,
+	uint32_t                       * timebase,
+	double                         * timeInterval,
+	PS4000A_DEVICE_RESOLUTION      resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aCheckForUpdate)
+(
+	int16_t handle,
+	PICO_FIRMWARE_INFO* firmwareInfos,
+    int16_t* nFirmwareInfos,
+    uint16_t* updatesRequired
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aStartFirmwareUpdate)
+(
+	int16_t handle,
+	PicoUpdateFirmwareProgress progress
+	);
+
+#endif

+ 1153 - 0
pico-tcp-service/pico-tcp-client/main.cpp

@@ -0,0 +1,1153 @@
+#include <iostream>
+#include <memory>
+#include <windows.h>
+#include <tuple>
+#include "picofunctions.h"
+#include "pugiconfig.hpp"
+#include "pugixml.hpp"
+#include "parser.hpp"
+#include "src/ActiveSocket.h"
+
+
+#define MAX_PACKET 4096
+using namespace std;
+
+std::vector<std::string> split(const std::string& s, const std::string& delimiter) {
+    std::vector<std::string> tokens;
+    size_t pos = 0;
+    std::string temp = s;
+    std::string token;
+    while ((pos = temp.find(delimiter)) != std::string::npos) {
+        token = temp.substr(0, pos);
+        tokens.push_back(token);
+        temp.erase(0, pos + delimiter.length());
+    }
+    tokens.push_back(temp);
+
+    return tokens;
+}
+
+class PicoLocalClient
+{
+    private:
+        CActiveSocket *socket;
+        uint8_t sndbuf[MAX_PACKET]{0};
+        uint8_t rcvbuf[MAX_PACKET]{0};
+        std::string line_edit;
+        std::vector<std::string> tokens;
+        uint8_t error_state = 0x00;
+        uint32_t error_code = 0x00000000;
+    public:
+        PicoLocalClient(CActiveSocket *socket) : socket(socket) {}
+        ~PicoLocalClient() { delete socket; }
+
+        int pico_open()
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x01;
+            if(socket->Send(sndbuf, 2) == 0)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xC1)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            cout << "Pico device opened" << endl;
+            return 0;
+        }
+
+        int pico_xml_config(const std::string& file_name)
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x02;
+            uint32_t size = file_name.size();
+            memcpy(sndbuf + 2, &size, sizeof(uint32_t));
+            memcpy(sndbuf + 6, file_name.c_str(), size);
+
+            if(socket->Send(sndbuf, size + 6) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xC2)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            cout << "Pico device configured" << endl;
+            return 0;
+        }
+
+        int pico_set_params(uint32_t* apoints, uint32_t* times, uint32_t sample_rate, uint32_t number_channels, uint32_t size)
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x0C;
+            memcpy(sndbuf + 2, &size, sizeof(uint32_t));
+            memcpy(sndbuf + 6, apoints, size * sizeof(uint32_t));
+            memcpy(sndbuf + 6 + size * sizeof(uint32_t), times, size * sizeof(uint32_t));
+            memcpy(sndbuf + 6 + 2 * size * sizeof(uint32_t), &sample_rate, sizeof(uint32_t));
+            memcpy(sndbuf + 10 + 2 * size * sizeof(uint32_t), &number_channels, sizeof(uint32_t));
+
+            if(socket->Send(sndbuf, size * 2 * sizeof(uint32_t) + 14) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xCC)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            cout << "Pico device parameters set" << endl;
+            return 0;
+        }
+
+        int pico_close()
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x03;
+            if(socket->Send(sndbuf, 2) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xC3)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            cout << "Pico device closed" << endl;
+            return 0;
+        }
+
+        int pico_get_current_params()
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x04;
+            if(socket->Send(sndbuf, 2) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xC4)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            if(bytes_received < 18)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+
+            uint32_t size;
+            memcpy(&size, rcvbuf + 2, sizeof(uint32_t));
+            if(size < 1)
+            {
+                cerr << "Invalid data size" << endl;
+                return -1;
+            }
+
+            uint32_t* apoints = new uint32_t[size / sizeof(uint32_t)];
+            memcpy(apoints, rcvbuf + 6, size);
+            for(uint32_t i = 0; i < size / sizeof(uint32_t); ++i)
+            {
+                cout << "apoints[" << i << "] = " << std::dec << apoints[i] << endl;
+            }
+            uint32_t* atimes = new uint32_t[size / sizeof(uint32_t)];
+            memcpy(atimes, rcvbuf + 6 + size, size);
+            for(uint32_t i = 0; i < size / sizeof(uint32_t); ++i)
+            {
+                cout << "atimes[" << i << "] = " << std::dec << atimes[i] << endl;
+            }
+
+            uint32_t sample_rate = 0;
+            memcpy(&sample_rate, rcvbuf + 6 + 2 * size, sizeof(uint32_t));
+            cout << "sample_rate = " << std::dec << sample_rate << endl;
+
+            uint32_t number_channels = 0;
+            memcpy(&number_channels, rcvbuf + 10 + 2 * size, sizeof(uint32_t));
+            cout << "number_channels = " << std::dec << number_channels << endl;
+
+            cout << "Pico device parameters retrieved" << endl;
+            return 0;
+        }
+
+        int pico_probe()
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x05;
+            if(socket->Send(sndbuf, 2) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xC5)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            cout << "Pico device probe completed" << endl;
+            return 0;
+        }
+
+        int pico_set_points(uint32_t* points, uint32_t size)
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x06;
+            memcpy(sndbuf + 2, &size, sizeof(uint32_t));
+            memcpy(sndbuf + 6, points, size * sizeof(uint32_t));
+
+            if(socket->Send(sndbuf, size * sizeof(uint32_t) + 6) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xC6)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            cout << "Pico device points set" << endl;
+            return 0;
+        }
+
+        int pico_set_sample_rate(uint32_t sample_rate)
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x07;
+            memcpy(sndbuf + 2, &sample_rate, sizeof(uint32_t));
+
+            if(socket->Send(sndbuf, sizeof(uint32_t) + 6) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+                return 0;
+            }
+            else if(rcvbuf[1] != 0xC7)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            cout << "Pico device sample rate set" << endl;
+            return 0;
+        }
+
+        int pico_set_times(uint32_t* times, uint32_t size)
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x08;
+            memcpy(sndbuf + 2, &size, sizeof(uint32_t));
+            memcpy(sndbuf + 6, times, size * sizeof(uint32_t));
+
+            if(socket->Send(sndbuf, size * sizeof(uint32_t) + 6) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xC8)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            cout << "Pico device times set" << endl;
+            return 0;
+        }
+
+        int pico_configure_channels(const uint32_t number_channels, uint8_t trigger_channel, int32_t direction, uint16_t threshold, int16_t autoTrigger_ms)
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x09;
+            memcpy(sndbuf + 2, &number_channels, sizeof(uint32_t));
+            memcpy(sndbuf + 6, &trigger_channel, sizeof(uint8_t));
+            memcpy(sndbuf + 7, &direction, sizeof(int32_t));
+            memcpy(sndbuf + 11, &threshold, sizeof(uint16_t));
+            memcpy(sndbuf + 13, &autoTrigger_ms, sizeof(int16_t));
+
+            if(socket->Send(sndbuf, 15) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xC9)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            cout << "Pico device channels configured" << endl;
+            return 0;
+        }
+
+        int pico_begin_measurement()
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x0A;
+            if(socket->Send(sndbuf, 2) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xCA)
+            {
+                cout << "Invalid command callback" << endl;
+            }
+
+            cout << "Pico device measurement started" << endl;
+            cout << "Measurement in progress..." << endl;
+
+            bool end_of_data = false;
+            while(!end_of_data)
+            {
+                if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+                {
+                    cerr << "Failed to receive data from socket" << endl;
+                    return -1;
+                }
+                bytes_received = socket->GetBytesReceived();
+                if(bytes_received == 0)
+                {
+                    cerr << "Server disconnected" << endl;
+                    return -1;
+                }
+                if(bytes_received < 2)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                if(rcvbuf[0] != 0xAA)
+                {
+                    cerr << "Invalid magic number" << endl;
+                    return -1;
+                }
+                if(rcvbuf[1] == 0xFF)
+                {
+                    if(bytes_received < 7)
+                    {
+                        cerr << "Invalid buffer size" << endl;
+                        return -1;
+                    }
+
+                    cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                    memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                    memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                    cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+                }
+
+                if(rcvbuf[1] == 0xCB)
+                {
+                    cout << "Measurement completed..." << endl;
+                    end_of_data = true;
+                }
+                else if(rcvbuf[1] = 0xCA)
+                {
+                    cout << "Measurement in progress..." << endl;
+                }
+                else
+                {
+                    cerr << "Invalid command callback" << endl;
+                    return -1;
+                }
+
+                cout << "Measurement in progress..." << endl;
+            }
+
+            cout << "Pico device measurement completed" << endl;
+            return 0;
+        }
+
+        int pico_stop()
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x0E;
+            if(socket->Send(sndbuf, 2) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xCE)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            cout << "Pico device measurement stopped" << endl;
+            return 0;
+        }
+
+        int pico_exit()
+        {
+            sndbuf[0] = 0xAA;
+            sndbuf[1] = 0x0D;
+            if(socket->Send(sndbuf, 2) == -1)
+            {
+                cerr << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            if(socket->Receive(MAX_PACKET, rcvbuf) == -1)
+            {
+                cerr << "Failed to receive data from socket" << endl;
+                return -1;
+            }
+
+            uint32_t bytes_received = socket->GetBytesReceived();
+            if(bytes_received == 0)
+            {
+                cerr << "Server disconnected" << endl;
+                return -1;
+            }
+            if(bytes_received < 2)
+            {
+                cerr << "Invalid buffer size" << endl;
+                return -1;
+            }
+            if(rcvbuf[0] != 0xAA)
+            {
+                cerr << "Invalid magic number" << endl;
+                return -1;
+            }
+
+            if(rcvbuf[1] == 0xFF)
+            {
+                if(bytes_received < 7)
+                {
+                    cerr << "Invalid buffer size" << endl;
+                    return -1;
+                }
+
+                cerr << "Error at ADC: " << std::hex << rcvbuf[2] << endl;
+                memcpy(&error_state, rcvbuf + 2, sizeof(uint8_t));
+                memcpy(&error_code, rcvbuf + 3, sizeof(uint32_t));
+                cerr << "Error code: " << std::hex << error_code << " " << return_fun(error_code) << endl;
+            }
+            else if(rcvbuf[1] != 0xCD)
+            {
+                cerr << "Invalid command callback" << endl;
+                return -1;
+            }
+
+            cout << "Pico device exited" << endl;
+            return 0;
+        }
+
+        int get_command()
+        {
+            if(true)
+            {
+                cout << "cmd$ ";
+                std::getline(std::cin, line_edit);
+                cout << endl;
+
+                tokens = split(line_edit, " ");
+
+                if(tokens.size() < 1)
+                {
+                    cerr << "Invalid command" << endl;
+                    cout << endl;
+                    return -1;
+                }
+
+                if(tokens[0] == "open")
+                {
+                    if(pico_open() != 0)
+                    {
+                        cerr << "Failed to open pico device" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                }
+                else if(tokens[0] == "xml_config")
+                {
+                    if(tokens.size() < 2)
+                    {
+                        cerr << "Invalid command" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                    if(pico_xml_config(tokens[1]) != 0)
+                    {
+                        cerr << "Failed to configure pico device" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                }
+                else if(tokens[0] == "set_params")
+                {
+                    if(tokens.size() < 5)
+                    {
+                        cerr << "Invalid command" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+
+                    std::vector<uint32_t> points;
+                    std::vector<uint32_t> times;
+                    uint32_t sample_rate = std::stoi(tokens[2]);
+                    uint32_t number_channels = std::stoi(tokens[3]);
+                    uint32_t size = std::stoi(tokens[4]);
+                    points = string_to_vector(tokens[5]);
+                    times = string_to_vector(tokens[6]);
+                    if(points.size() != size || times.size() != size)
+                    {
+                        cerr << "Invalid data size" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                    if(pico_set_params(points.data(), times.data(), sample_rate, number_channels, size) != 0)
+                    {
+                        cerr << "Failed to set pico device parameters" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                    return 0;
+                }
+                else if(tokens[0] == "close")
+                {
+                    if(pico_close() != 0)
+                    {
+                        cerr << "Failed to close pico device" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                }
+                else if(tokens[0] == "exit")
+                {
+                    if(pico_exit() != 0)
+                    {
+                        cerr << "Failed to exit pico device" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+
+                    return 1;
+                }
+                else if(tokens[0] == "get_current_params")
+                {
+                    if(pico_get_current_params() != 0)
+                    {
+                        cerr << "Failed to get pico device parameters" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                }
+                else if(tokens[0] == "probe")
+                {
+                    if(pico_probe() != 0)
+                    {
+                        cerr << "Failed to probe pico device" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                }
+                else if(tokens[0] == "set_points")
+                {
+                    if(tokens.size() < 3)
+                    {
+                        cerr << "Invalid command" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+
+                    uint32_t size = std::stoi(tokens[1]);
+
+                    std::vector<uint32_t> points = string_to_vector(tokens[2]);
+                    if(points.size() != size)
+                    {
+                        cerr << "Invalid data size" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                    if(pico_set_points(points.data(), size) != 0)
+                    {
+                        cerr << "Failed to set pico device points" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                }
+                else if(tokens[0] == "set_sample_rate")
+                {
+                    if(tokens.size() < 2)
+                    {
+                        cerr << "Invalid command" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+
+                    uint32_t sample_rate = std::stoi(tokens[1]);
+                    if(pico_set_sample_rate(sample_rate) != 0)
+                    {
+                        cerr << "Failed to set pico device sample rate" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                }
+                else if(tokens[0] == "set_times")
+                {
+                    if(tokens.size() < 3)
+                    {
+                        cerr << "Invalid command" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+
+                    uint32_t size = std::stoi(tokens[1]);
+                    std::vector<uint32_t> times = string_to_vector(tokens[2]);
+                    if(times.size() != size)
+                    {
+                        cerr << "Invalid data size" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                    if(pico_set_times(times.data(), size) != 0)
+                    {
+                        cerr << "Failed to set pico device times" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                }
+                else if(tokens[0] == "configure_channels")
+                {
+                    if(tokens.size() < 6)
+                    {
+                        cerr << "Invalid command" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                    uint32_t number_channels = std::stoi(tokens[1]); // number of channels (1-8)
+                    uint8_t trigger_channel = std::stoi(tokens[2]); // trigger channel (0-7, 0 = channel A, 1 = channel B, ...)
+                    int32_t direction = std::stoi(tokens[3]); // trigger direction (0 = rising, 1 = falling)
+                    uint16_t threshold = std::stoi(tokens[4]); // trigger threshold (0-65535)
+                    int16_t autoTrigger_ms = std::stoi(tokens[5]); // auto trigger time (0-65535 ms)
+                    if(pico_configure_channels(number_channels, trigger_channel, direction, threshold, autoTrigger_ms) != 0)
+                    {
+                        cerr << "Failed to configure pico device channels" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                }
+                else if(tokens[0] == "begin_measurement")
+                {
+                    if(pico_begin_measurement() != 0)
+                    {
+                        cerr << "Failed to begin pico device measurement" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                }
+                else if(tokens[0] == "stop")
+                {
+                    if(pico_stop() != 0)
+                    {
+                        cerr << "Failed to stop pico device measurement" << endl;
+                        cout << endl;
+                        return -1;
+                    }
+                }
+                else if(tokens[0] == "help")
+                {
+                    cout << "Available commands:" << endl;
+                    cout << "open" << endl;
+                    cout << "xml_config <filename>" << endl;
+                    cout << "set_params <points> <times> <sample_rate> <number_channels> <size>" << endl;
+                    cout << "close" << endl;
+                    cout << "exit" << endl;
+                    cout << "get_current_params" << endl;
+                    cout << "probe" << endl;
+                    cout << "set_points <points> <size>" << endl;
+                    cout << "set_sample_rate <sample_rate>" << endl;
+                    cout << "set_times <times> <size>" << endl;
+                    cout << "configure_channels <number_channels> <trigger_channel> <direction> <threshold> <autoTrigger_ms>" << endl;
+                    cout << "begin_measurement" << endl;
+                    cout << "stop" << endl;
+                }
+                else if(tokens[0] == "test")
+                {
+                    cout << "Test command received" << endl;
+                }
+                else
+                {
+                    cerr << "Unknown command" << endl;
+                    cout << endl;
+                    return -1;
+                }
+            }
+
+            cout << endl;
+
+            return 0;
+        }
+};
+
+int main()
+{
+    cout << "Open socket" << endl;
+    CActiveSocket SocketActive(CSimpleSocket::CSocketType::SocketTypeTcp);
+    if (!SocketActive.Initialize())
+    {
+        cerr << "Socket initialization failed" << endl;
+        return -1;
+    }
+    if(!SocketActive.Open("127.0.0.1", 5003))
+    {
+        cerr << "Socket opening failed" << endl;
+        return -1;
+    }
+
+    PicoLocalClient pico_client(&SocketActive);
+
+    while(pico_client.get_command() != 1) {
+        // empty
+    }
+
+    return 0;
+}
+
+

BIN
pico-tcp-service/pico-tcp-client/obj/Debug/main.o


BIN
pico-tcp-service/pico-tcp-client/obj/Debug/parser.o


BIN
pico-tcp-service/pico-tcp-client/obj/Debug/picofunctions.o


BIN
pico-tcp-service/pico-tcp-client/obj/Debug/pugixml.o


BIN
pico-tcp-service/pico-tcp-client/obj/Debug/src/ActiveSocket.o


BIN
pico-tcp-service/pico-tcp-client/obj/Debug/src/PassiveSocket.o


BIN
pico-tcp-service/pico-tcp-client/obj/Debug/src/SimpleSocket.o


BIN
pico-tcp-service/pico-tcp-client/obj/Debug/src/simplelogger.o


+ 26 - 0
pico-tcp-service/pico-tcp-client/parser.cpp

@@ -0,0 +1,26 @@
+#include "parser.hpp"
+
+Parser::Parser (int argc, char** argv) {
+    for(int i = 0; i < argc; i++) {
+        flags.push_back(argv[i]);
+    }
+
+}
+
+bool Parser::cmdOption (const std::string& option) {
+    return std::find(flags.begin(), flags.end(), option) != flags.end();
+}
+
+const std::string& Parser::setFilename(const std::string& option, const int32_t points, const uint32_t number_channels, const uint32_t freq) {
+    if(cmdOption(option)) {
+        auto it = std::find(flags.begin(), flags.end(), option) - flags.begin();
+        if(it - 1 == flags.size()) {
+            return std::to_string(points) + std::to_string(number_channels) + std::to_string(freq);
+        }
+        else {
+            return flags[it + 1];
+        }
+    }
+
+}
+

+ 16 - 0
pico-tcp-service/pico-tcp-client/parser.hpp

@@ -0,0 +1,16 @@
+#pragma once
+#include <vector>
+#include <string>
+#include <algorithm>
+class Parser {
+public:
+    Parser(int argc, char** argv);
+    ~Parser() = default;
+
+    bool cmdOption(const std::string& option);
+   const std::string& setFilename(const std::string& option, const int32_t points, const uint32_t number_channels, const uint32_t freq) ;
+
+
+private:
+        std::vector<std::string> flags;
+};

BIN
pico-tcp-service/pico-tcp-client/pico-tcp-client.exe


+ 77 - 0
pico-tcp-service/pico-tcp-client/pico-tcp.cbp

@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
+<CodeBlocks_project_file>
+	<FileVersion major="1" minor="6" />
+	<Project>
+		<Option title="pico-tcp" />
+		<Option pch_mode="2" />
+		<Option compiler="gcc" />
+		<Build>
+			<Target title="Debug">
+				<Option output="bin/Debug/pico-tcp" prefix_auto="1" extension_auto="1" />
+				<Option object_output="obj/Debug/" />
+				<Option type="1" />
+				<Option compiler="gcc" />
+				<Compiler>
+					<Add option="-g" />
+				</Compiler>
+			</Target>
+			<Target title="Release">
+				<Option output="bin/Release/pico-tcp" prefix_auto="1" extension_auto="1" />
+				<Option object_output="obj/Release/" />
+				<Option type="1" />
+				<Option compiler="gcc" />
+				<Compiler>
+					<Add option="-O2" />
+				</Compiler>
+				<Linker>
+					<Add option="-s" />
+				</Linker>
+			</Target>
+		</Build>
+		<Compiler>
+			<Add option="-Wall" />
+			<Add option="-fexceptions" />
+		</Compiler>
+		<Unit filename="inc/HRDL.h" />
+		<Unit filename="inc/PicoCallback.h" />
+		<Unit filename="inc/PicoConnectProbes.h" />
+		<Unit filename="inc/PicoDeviceDefinitionsExperimental.h" />
+		<Unit filename="inc/PicoDeviceEnums.h" />
+		<Unit filename="inc/PicoDeviceStructs.h" />
+		<Unit filename="inc/PicoStatus.h" />
+		<Unit filename="inc/PicoVersion.h" />
+		<Unit filename="inc/pl1000Api.h" />
+		<Unit filename="inc/plcm3Api.h" />
+		<Unit filename="inc/ps2000.h" />
+		<Unit filename="inc/ps2000aApi.h" />
+		<Unit filename="inc/ps3000.h" />
+		<Unit filename="inc/ps3000aApi.h" />
+		<Unit filename="inc/ps4000Api.h" />
+		<Unit filename="inc/ps4000aApi.h" />
+		<Unit filename="inc/ps5000Api.h" />
+		<Unit filename="inc/ps5000aApi.h" />
+		<Unit filename="inc/ps6000Api.h" />
+		<Unit filename="inc/ps6000aApi.h" />
+		<Unit filename="inc/ps6000aApiExperimental.h" />
+		<Unit filename="inc/usbDrDaqApi.h" />
+		<Unit filename="inc/usbPT104Api.h" />
+		<Unit filename="inc/usbtc08.h" />
+		<Unit filename="libps4000a/PicoStatus.h" />
+		<Unit filename="libps4000a/ps4000aApi.h" />
+		<Unit filename="main.cpp" />
+		<Unit filename="parser.cpp" />
+		<Unit filename="picofunctions.cpp" />
+		<Unit filename="pugixml.cpp" />
+		<Unit filename="src/ActiveSocket.cpp" />
+		<Unit filename="src/ActiveSocket.h" />
+		<Unit filename="src/Host.h" />
+		<Unit filename="src/PassiveSocket.cpp" />
+		<Unit filename="src/PassiveSocket.h" />
+		<Unit filename="src/SimpleSocket.cpp" />
+		<Unit filename="src/SimpleSocket.h" />
+		<Unit filename="src/StatTimer.h" />
+		<Extensions>
+			<lib_finder disable_auto="1" />
+		</Extensions>
+	</Project>
+</CodeBlocks_project_file>

+ 370 - 0
pico-tcp-service/pico-tcp-client/pico-tcp.depend

@@ -0,0 +1,370 @@
+# depslib dependency file v1.0
+1732277880 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\parser.cpp
+	"parser.hpp"
+
+1732277792 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\parser.hpp
+	<vector>
+	<string>
+	<algorithm>
+
+1745399888 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\picofunctions.cpp
+	"picofunctions.h"
+
+1745428916 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\picofunctions.h
+	<stdio.h>
+	<algorithm>
+	<chrono>
+	<fstream>
+	<iomanip>
+	<iostream>
+	<thread>
+	<tuple>
+	<vector>
+	"pugixml.hpp"
+	<conio.h>
+	"windows.h"
+	<stdio.h>
+	<chrono>
+	<cstring>
+	<thread>
+	"libps4000a/PicoStatus.h"
+	"libps4000a/ps4000aApi.h"
+	"pugiconfig.hpp"
+	"pugixml.hpp"
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\pugixml.hpp
+	"pugiconfig.hpp"
+	<stddef.h>
+	<exception>
+	<iterator>
+	<iosfwd>
+	<string>
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\pugiconfig.hpp
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\libps4000a\picostatus.h
+	<stdint.h>
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\libps4000a\ps4000aapi.h
+	<stdint.h>
+	"PicoStatus.h"
+	"../inc/PicoCallback.h"
+	"../inc/PicoConnectProbes.h"
+	"../inc/PicoVersion.h"
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picocallback.h
+	<stdint.h>
+	"PicoDeviceEnums.h"
+	"PicoDeviceStructs.h"
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picodeviceenums.h
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picodevicestructs.h
+	<stdint.h>
+	"PicoConnectProbes.h"
+	"PicoDeviceEnums.h"
+	"PicoStatus.h"
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picoconnectprobes.h
+	<stdint.h>
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picostatus.h
+	<stdint.h>
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picoversion.h
+	<stdint.h>
+	"PicoStatus.h"
+
+1732145702 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\pugixml.cpp
+	"pugixml.hpp"
+	<stdlib.h>
+	<stdio.h>
+	<string.h>
+	<assert.h>
+	<limits.h>
+	<wchar.h>
+	<math.h>
+	<float.h>
+	<istream>
+	<ostream>
+	<string>
+	<new>
+	<sys/stat.h>
+	<stdint.h>
+
+1741610104 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\activesocket.cpp
+	"ActiveSocket.h"
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\activesocket.h
+	"SimpleSocket.h"
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\simplesocket.h
+	<sys/stat.h>
+	<stdlib.h>
+	<stdio.h>
+	<stdarg.h>
+	<errno.h>
+	<sys/socket.h>
+	<netinet/in.h>
+	<arpa/inet.h>
+	<netinet/tcp.h>
+	<netinet/ip.h>
+	<netdb.h>
+	<linux/if_packet.h>
+	<linux/if_ether.h>
+	<linux/if.h>
+	<sys/sendfile.h>
+	<net/if.h>
+	<sys/time.h>
+	<sys/uio.h>
+	<unistd.h>
+	<fcntl.h>
+	<io.h>
+	<winsock2.h>
+	<ws2tcpip.h>
+	"Host.h"
+	"StatTimer.h"
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\host.h
+	<limits.h>
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\stattimer.h
+	<string.h>
+	<Winsock2.h>
+	<time.h>
+	<stdio.h>
+	<sys/time.h>
+	"Host.h"
+
+1741610104 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\passivesocket.cpp
+	"PassiveSocket.h"
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\passivesocket.h
+	"ActiveSocket.h"
+
+1741610104 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\simplelogger.cpp
+	"simplelogger.hpp"
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\simplelogger.hpp
+	<iostream>
+	<iomanip>
+	<chrono>
+	<ctime>
+	<sstream>
+	<fstream>
+	<sstream>
+	<fstream>
+
+1741610104 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\simplesocket.cpp
+	"SimpleSocket.h"
+
+1745429820 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\main.cpp
+	<iostream>
+	<memory>
+	<windows.h>
+	<tuple>
+	"picofunctions.h"
+	"pugiconfig.hpp"
+	"pugixml.hpp"
+	"simplelogger.hpp"
+	"parser.hpp"
+	"src/PassiveSocket.h"
+
+1736707942 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\simplelogger.hpp
+	<iostream>
+	<iomanip>
+	<chrono>
+	<ctime>
+	<sstream>
+	<fstream>
+	<sstream>
+	<fstream>
+	<windows.h>
+	<winbase.h>
+	<sys/stat.h>
+	<unistd.h>
+
+1732277880 source:c:\lf_mri\pico-tcp-service\pico-tcp-client\parser.cpp
+	"parser.hpp"
+
+1732277792 c:\lf_mri\pico-tcp-service\pico-tcp-client\parser.hpp
+	<vector>
+	<string>
+	<algorithm>
+
+1745852008 source:c:\lf_mri\pico-tcp-service\pico-tcp-client\picofunctions.cpp
+	"picofunctions.h"
+
+1745428916 c:\lf_mri\pico-tcp-service\pico-tcp-client\picofunctions.h
+	<stdio.h>
+	<algorithm>
+	<chrono>
+	<fstream>
+	<iomanip>
+	<iostream>
+	<thread>
+	<tuple>
+	<vector>
+	"pugixml.hpp"
+	<conio.h>
+	"windows.h"
+	<stdio.h>
+	<chrono>
+	<cstring>
+	<thread>
+	"libps4000a/PicoStatus.h"
+	"libps4000a/ps4000aApi.h"
+	"pugiconfig.hpp"
+	"pugixml.hpp"
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp-client\pugixml.hpp
+	"pugiconfig.hpp"
+	<stddef.h>
+	<exception>
+	<iterator>
+	<iosfwd>
+	<string>
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp-client\pugiconfig.hpp
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp-client\libps4000a\picostatus.h
+	<stdint.h>
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp-client\libps4000a\ps4000aapi.h
+	<stdint.h>
+	"PicoStatus.h"
+	"../inc/PicoCallback.h"
+	"../inc/PicoConnectProbes.h"
+	"../inc/PicoVersion.h"
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp-client\inc\picocallback.h
+	<stdint.h>
+	"PicoDeviceEnums.h"
+	"PicoDeviceStructs.h"
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp-client\inc\picodeviceenums.h
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp-client\inc\picodevicestructs.h
+	<stdint.h>
+	"PicoConnectProbes.h"
+	"PicoDeviceEnums.h"
+	"PicoStatus.h"
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp-client\inc\picoconnectprobes.h
+	<stdint.h>
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp-client\inc\picostatus.h
+	<stdint.h>
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp-client\inc\picoversion.h
+	<stdint.h>
+	"PicoStatus.h"
+
+1732145702 source:c:\lf_mri\pico-tcp-service\pico-tcp-client\pugixml.cpp
+	"pugixml.hpp"
+	<stdlib.h>
+	<stdio.h>
+	<string.h>
+	<assert.h>
+	<limits.h>
+	<wchar.h>
+	<math.h>
+	<float.h>
+	<istream>
+	<ostream>
+	<string>
+	<new>
+	<sys/stat.h>
+	<stdint.h>
+
+1741610104 source:c:\lf_mri\pico-tcp-service\pico-tcp-client\src\activesocket.cpp
+	"ActiveSocket.h"
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp-client\src\activesocket.h
+	"SimpleSocket.h"
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp-client\src\simplesocket.h
+	<sys/stat.h>
+	<stdlib.h>
+	<stdio.h>
+	<stdarg.h>
+	<errno.h>
+	<sys/socket.h>
+	<netinet/in.h>
+	<arpa/inet.h>
+	<netinet/tcp.h>
+	<netinet/ip.h>
+	<netdb.h>
+	<linux/if_packet.h>
+	<linux/if_ether.h>
+	<linux/if.h>
+	<sys/sendfile.h>
+	<net/if.h>
+	<sys/time.h>
+	<sys/uio.h>
+	<unistd.h>
+	<fcntl.h>
+	<io.h>
+	<winsock2.h>
+	<ws2tcpip.h>
+	"Host.h"
+	"StatTimer.h"
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp-client\src\host.h
+	<limits.h>
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp-client\src\stattimer.h
+	<string.h>
+	<Winsock2.h>
+	<time.h>
+	<stdio.h>
+	<sys/time.h>
+	"Host.h"
+
+1741610104 source:c:\lf_mri\pico-tcp-service\pico-tcp-client\src\passivesocket.cpp
+	"PassiveSocket.h"
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp-client\src\passivesocket.h
+	"ActiveSocket.h"
+
+1741610104 source:c:\lf_mri\pico-tcp-service\pico-tcp-client\src\simplelogger.cpp
+	"simplelogger.hpp"
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp-client\src\simplelogger.hpp
+	<iostream>
+	<iomanip>
+	<chrono>
+	<ctime>
+	<sstream>
+	<fstream>
+	<sstream>
+	<fstream>
+
+1741610104 source:c:\lf_mri\pico-tcp-service\pico-tcp-client\src\simplesocket.cpp
+	"SimpleSocket.h"
+
+1745850909 source:c:\lf_mri\pico-tcp-service\pico-tcp-client\main.cpp
+	<iostream>
+	<memory>
+	<windows.h>
+	<tuple>
+	"picofunctions.h"
+	"pugiconfig.hpp"
+	"pugixml.hpp"
+	"parser.hpp"
+	"src/ActiveSocket.h"
+
+1736707942 c:\lf_mri\pico-tcp-service\pico-tcp-client\simplelogger.hpp
+	<iostream>
+	<iomanip>
+	<chrono>
+	<ctime>
+	<sstream>
+	<fstream>
+	<sstream>
+	<fstream>
+	<windows.h>
+	<winbase.h>
+	<sys/stat.h>
+	<unistd.h>
+

+ 30 - 0
pico-tcp-service/pico-tcp-client/pico-tcp.layout

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
+<CodeBlocks_layout_file>
+	<FileVersion major="1" minor="0" />
+	<ActiveTarget name="Debug" />
+	<File name="main.cpp" open="1" top="1" tabpos="1" split="0" active="1" splitpos="0" zoom_1="-2" zoom_2="0">
+		<Cursor>
+			<Cursor1 position="39288" topLine="173" />
+		</Cursor>
+		<Folding>
+			<Collapse line="44" />
+			<Collapse line="100" />
+			<Collapse line="160" />
+			<Collapse line="221" />
+			<Collapse line="276" />
+			<Collapse line="366" />
+			<Collapse line="421" />
+			<Collapse line="479" />
+			<Collapse line="537" />
+			<Collapse line="595" />
+			<Collapse line="656" />
+			<Collapse line="771" />
+			<Collapse line="826" />
+		</Folding>
+	</File>
+	<File name="picofunctions.cpp" open="1" top="0" tabpos="2" split="0" active="1" splitpos="0" zoom_1="0" zoom_2="0">
+		<Cursor>
+			<Cursor1 position="11126" topLine="288" />
+		</Cursor>
+	</File>
+</CodeBlocks_layout_file>

BIN
pico-tcp-service/pico-tcp-client/picocv.dll


+ 340 - 0
pico-tcp-service/pico-tcp-client/picofunctions.cpp

@@ -0,0 +1,340 @@
+#include "picofunctions.h"
+#define DEFAULT_FREQ 80000000
+
+uint32_t
+check(const string& param)
+{
+    uint32_t result = stod(param);
+    if (result > 0)
+    {
+        return uint32_t(result);
+    }
+
+    else
+        return 1;
+}
+
+bool
+ShowParameterText(string param, pugi::xml_node node)
+{
+    cout << "Showing parameter : " << param << std::endl;
+
+    if (node == nullptr)
+    {
+        cout << "ERROR no such parameter : " << param << std::endl;
+        return false;
+    }
+    if (strlen(node.text().get()) == 0)
+    {
+        cout << "ERROR no text for parameter : " << param << std::endl;
+        return false;
+    }
+
+    cout << param << " get text: " << node.text().get() << std::endl;
+    cout << param << " get as int : " << check(node.text().get()) << std::endl;
+
+    return true;
+}
+
+string
+return_fun(uint32_t value)
+{
+    string rv;
+    switch (value)
+    {
+            // return values from set channel
+        case PICO_OK: rv = "PICO_OK"; break;
+        case PICO_USER_CALLBACK: rv = "PICO_USER_CALLBACK"; break;
+        case PICO_INVALID_HANDLE: rv = "INVALID HANDLE"; break;
+        case PICO_INVALID_CHANNEL: rv = "PICO_INVALID_CHANNEL"; break;
+        case PICO_INVALID_VOLTAGE_RANGE: rv = "PICO_INVALID_VOLTAGE_RANGE"; break;
+        case PICO_DRIVER_FUNCTION: rv = "PICO_DRIVER_FUNCTION"; break;
+        case PICO_INVALID_COUPLING: rv = "PICO_INVALID_COUPLING"; break;
+        case PICO_INVALID_ANALOGUE_OFFSET: rv = "PICO_INVALID_ANALOG_OFFSET"; break;
+        case PICO_WARNING_PROBE_CHANNEL_OUT_OF_SYNC:
+            rv = "PICO_WARNING_PROBE_CHANNEL_OUT_OF_SYNC";
+            break;
+        case PICO_PROBE_NOT_POWERED_WITH_DC_POWER_SUPPLY:
+            rv = "PICO_PROBE_NOT_POWERED_WITH_DC_POWER_SUPPLY";
+            break;
+        case PICO_PROBE_POWER_DC_POWER_SUPPLY_REQUIRED:
+            rv = "PICO_PROBE_POWER_DC_POWER_SUPPLY_REQUIRED";
+            break;
+        // return values from flash led
+        case PICO_BUSY: rv = "PICO_BUSY"; break;
+        case PICO_MEMORY: rv = "PICO_MEMORY"; break;
+        case PICO_INTERNAL_ERROR: rv = "PICO_INTERNAL_ERROR"; break;
+        case PICO_POWER_SUPPLY_UNDERVOLTAGE: rv = "PICO_POWER_SUPPLY_UNDERVOLTAGE"; break;
+        case PICO_NOT_RESPONDING: rv = "PICO_NOT_RESPONDING"; break;
+        case PICO_POWER_SUPPLY_CONNECTED: rv = "PICO_POWER_SUPPLY_CONNECTED"; break;
+        case PICO_POWER_SUPPLY_NOT_CONNECTED: rv = "PICO_POWER_SUPPLY_NOT_CONNECTED"; break;
+        case PICO_TIMEOUT: rv = "PICO_TIMEOUT"; break;
+        case PICO_RESOURCE_ERROR: rv = "PICO_RESOURCE_ERROR"; break;
+        case PICO_DEVICE_NOT_FUNCTIONING: rv = "PICO_DEVICE_NOT_FUNCTIONING"; break;
+        // return values from open
+        case PICO_OS_NOT_SUPPORTED: rv = "PICO_OS_NOT_SUPPORTED"; break;
+        case PICO_OPEN_OPERATION_IN_PROGRESS: rv = "PICO_OPEN_OPERATION_IN_PROGRESS"; break;
+        case PICO_EEPROM_CORRUPT: rv = "PICO_EEPROM_CORRUPT"; break;
+        case PICO_KERNEL_DRIVER_TOO_OLD: rv = "PICO_KERNEL_DRIVER_TOO_OLD"; break;
+        case PICO_FW_FAIL: rv = "PICO_FW_FAIL"; break;
+        case PICO_MAX_UNITS_OPENED: rv = "PICO_MAX_UNITS_OPENED"; break;
+        case PICO_NOT_FOUND: rv = "PICO_NOT_FOUND"; break;
+        case PICO_USB3_0_DEVICE_NON_USB3_0_PORT: rv = "PICO_USB3_0_DEVICE_NON_USB3_0_PORT"; break;
+        case PICO_MEMORY_FAIL: rv = "PICO_MEMORY_FAIL"; break;
+        case PICO_HARDWARE_VERSION_NOT_SUPPORTED: rv = "PICO_HARDWARE_VERSION_NOT_SUPPORTED"; break;
+        case PICO_NOT_USED: rv = "PICO_NOT_USED"; break;
+        case PICO_FPGA_FAIL: rv = "PICO_FPGA_FAIL"; break;
+
+        // return values from get timebase
+        case PICO_TOO_MANY_SAMPLES: rv = "PICO_TOO_MANY_SAMPLES"; break;
+        case PICO_INVALID_TIMEBASE: rv = "PICO_INVALID_TIMEBASE"; break;
+        case PICO_INVALID_PARAMETER: rv = "PICO_INVALID_PARAMETER"; break;
+        case PICO_SEGMENT_OUT_OF_RANGE: rv = "PICO_SEGMENT_OUT_OF_RANGE"; break;
+        // return values from run block
+        case PICO_INVALID_TRIGGER_CHANNEL: rv = "PICO_INVALID_TRIGGER_CHANNEL"; break;
+        case PICO_INVALID_CONDITION_CHANNEL: rv = "PICO_INVALID_CONDITION_CHANNEL"; break;
+        case PICO_CONFIG_FAIL: rv = "PICO_CONFIG_FAIL"; break;
+        case PICO_TRIGGER_ERROR: rv = "PICO_TRIGGER_ERROR"; break;
+        case PICO_NOT_USED_IN_THIS_CAPTURE_MODE: rv = "PICO_NOT_USED_IN_THIS_CAPTURE_MODE"; break;
+        case PICO_TRIGGER_WITHIN_PRE_NOT_ALLOWED_WITH_DELAY:
+            rv = "PICO_TRIGGER_WITHIN_PRE_NOT_ALLOWED_WITH_DELAY";
+            break;
+        case PICO_INVALID_NUMBER_CHANNELS_FOR_RESOLUTION:
+            rv = "PICO_INVALID_NUMBER_CHANNELS_FOR_RESOLUTION";
+            break;
+        case PICO_NOT_ENOUGH_SEGMENTS: rv = "PICO_NOT_ENOUGH_SEGMENTS"; break;
+        case PICO_NO_TRIGGER_ENABLED_FOR_TRIGGER_IN_PRE_TRIG:
+            rv = "PICO_NO_TRIGGER_ENABLED_FOR_TRIGGER_IN_PRE_TRIG";
+            break;
+        // return values from set data buffer
+        case PICO_RATIO_MODE_NOT_SUPPORTED: rv = "PICO_RATIO_MODE_NOT_SUPPORTED"; break;
+        // return values from get values
+        case PICO_NO_SAMPLES_AVAILABLE: rv = "PICO_NO_SAMPLES_AVAILABLE"; break;
+        case PICO_DEVICE_SAMPLING: rv = "PICO_DEVICE_SAMPLING"; break;
+        case PICO_NULL_PARAMETER: rv = "PICO_NULL_PARAMETER"; break;
+        case PICO_DATA_NOT_AVAILABLE: rv = "PICO_DATA_NOT_AVAILABLE"; break;
+        case PICO_STARTINDEX_INVALID: rv = "PICO_STARTINDEX_INVALID"; break;
+        case PICO_INVALID_SAMPLERATIO: rv = "PICO_INVALID_SAMPLERATIO"; break;
+        case PICO_INVALID_CALL: rv = "PICO_INVALID_CALL"; break;
+        case PICO_BUFFERS_NOT_SET: rv = "PICO_BUFFERS_NOT_SET"; break;
+        case PICO_ETS_NOT_RUNNING: rv = "PICO_ETS_NOT_RUNNING"; break;
+        // return value from SetTriggerChannelConditions
+        case PICO_TOO_MANY_CHANNELS_IN_USE: rv = "PICO_TOO_MANY_CHANNELS_IN_USE"; break;
+        case PICO_INVALID_CONDITION_INFO: rv = "PICO_INVALID_CONDITION_INFO"; break;
+        case PICO_DUPLICATE_CONDITION_SOURCE: rv = "PICO_DUPLICATE_CONDITION_SOURCE"; break;
+        case PICO_CANCELLED: rv = "PICO_CANCELLED"; break;
+
+        default: rv = "unknown return value = " + std::to_string(value);
+    }
+    return rv;
+}
+
+Parse_data
+parse_xml_function(const char* file_name)
+{
+    pugi::xml_document doc;
+    pugi::xml_parse_result result = doc.load_file(file_name);
+
+    if (!result)
+    {
+        std::cerr << "Ошибка загрузки XML-файла: " << result.description() << std::endl;
+    }
+
+    pugi::xml_node root = doc.child("root");
+
+    string points = root.child("points").child("value").text().as_string();
+    int32_t num_of_channels = root.child("num_of_channels").child("value").text().as_int();
+    string times = root.child("times").child("value").text().as_string();
+    int32_t sample_freq = root.child("sample_freq").child("value").text().as_int();
+
+    return std::make_tuple(points, num_of_channels, times, sample_freq);
+}
+
+std::vector<uint32_t>
+string_to_vector(string times)
+{
+    times = times.substr(1, times.length() - 2);
+
+    std::vector<uint32_t> vec_times;
+    std::stringstream ss(times);
+    string token;
+
+    while (std::getline(ss, token, ','))
+    {
+        vec_times.push_back(std::stoi(token));
+    }
+
+    return vec_times;
+}
+
+std::vector<PS4000A_CHANNEL>
+create_channel(const int32_t& num_of_channels)
+{
+    std::vector<PS4000A_CHANNEL> channels;
+
+    for (int32_t i = 0; i < num_of_channels; i++)
+    {
+        switch (i)
+        {
+            case 0:
+            {
+                PS4000A_CHANNEL trigger_channel{PS4000A_CHANNEL_A};
+                channels.push_back(trigger_channel);
+                break;
+            }
+            case 1:
+            {
+                PS4000A_CHANNEL data2_channel{PS4000A_CHANNEL_B};
+                channels.push_back(data2_channel);
+                break;
+            }
+            case 2:
+            {
+                PS4000A_CHANNEL data3_channel{PS4000A_CHANNEL_C};
+                channels.push_back(data3_channel);
+                break;
+            }
+            case 3:
+            {
+                PS4000A_CHANNEL data4_channel{PS4000A_CHANNEL_D};
+                channels.push_back(data4_channel);
+                break;
+            }
+            case 4:
+            {
+                PS4000A_CHANNEL data5_channel{PS4000A_CHANNEL_E};
+                channels.push_back(data5_channel);
+                break;
+            }
+            case 5:
+            {
+                PS4000A_CHANNEL data6_channel{PS4000A_CHANNEL_F};
+                channels.push_back(data6_channel);
+                break;
+            }
+            case 6:
+            {
+                PS4000A_CHANNEL data7_channel{PS4000A_CHANNEL_G};
+                channels.push_back(data7_channel);
+                break;
+            }
+            case 7:
+            {
+                PS4000A_CHANNEL data8_channel{PS4000A_CHANNEL_H};
+                channels.push_back(data8_channel);
+                break;
+            }
+        }
+    }
+    return channels;
+}
+
+void writing_data(const std::vector<int16_t*>& vec_buffer, const int32_t bufferLth,
+                  const int32_t NUMBER_OF_CHANNELS)
+{
+    // Получаем текущее время
+    std::time_t now = std::time(nullptr);
+    std::tm* now_tm = std::localtime(&now);
+
+    #ifdef _WIN32
+    CreateDirectoryA("output", NULL);
+    #endif // _WIN32
+
+    // Формируем имя файла с текущей датой и временем
+    std::stringstream filename;
+
+    #ifdef _WIN32
+    filename << "output\\";
+    #endif // _WIN32
+
+    filename << "data_"
+             << std::put_time(now_tm, "%Y-%m-%d_%H-%M-%S")
+             << ".csv";
+
+
+
+    // Открываем новый файл для записи (не для дозаписи)
+    std::ofstream testfile(filename.str());
+
+    if (testfile.is_open())
+    {
+        for (int i = 0; i < bufferLth; ++i)
+        {
+            for (int j = 0; j < NUMBER_OF_CHANNELS; ++j)
+            {
+                testfile << vec_buffer[j][i] << ",";  // Вывод значений
+            }
+
+            testfile << "\n";
+        }
+
+        testfile.close();
+    }
+    else
+    {
+        // Обработка ошибки открытия файла, если необходимо
+       std::cerr << "Unable to open file to write data" ;
+    }
+}
+
+void writing_data_fixed_name(const std::string name, const std::vector<int16_t*>& vec_buffer, const int32_t bufferLth,
+                  const int32_t NUMBER_OF_CHANNELS)
+{
+    // Получаем текущее время
+    std::time_t now = std::time(nullptr);
+    std::tm* now_tm = std::localtime(&now);
+
+    #ifdef _WIN32
+    CreateDirectoryA("output", NULL);
+    #endif // _WIN32
+
+    // Формируем имя файла с текущей датой и временем
+    std::stringstream filename;
+
+    #ifdef _WIN32
+    filename << "output\\";
+    #endif // _WIN32
+
+    filename << name
+             << ".csv";
+
+
+
+    // Открываем новый файл для записи (не для дозаписи)
+    std::ofstream testfile(filename.str());
+
+    if (testfile.is_open())
+    {
+        for (int i = 0; i < bufferLth; ++i)
+        {
+            for (int j = 0; j < NUMBER_OF_CHANNELS; ++j)
+            {
+                testfile << vec_buffer[j][i] << ",";  // Вывод значений
+            }
+
+            testfile << "\n";
+        }
+
+        testfile.close();
+    }
+    else
+    {
+        // Обработка ошибки открытия файла, если необходимо
+       std::cerr << "Unable to open file to write data" ;
+    }
+}
+
+void
+free_buffers(const std::vector<int16_t*>& vec_buffer)
+{
+    for (const auto& it : vec_buffer)
+    {
+        delete[] it;
+    }
+}
+
+uint32_t
+timebase_choice(const int32_t SAMPLE_FREQ)
+{
+    return DEFAULT_FREQ / SAMPLE_FREQ - 1;
+}

+ 75 - 0
pico-tcp-service/pico-tcp-client/picofunctions.h

@@ -0,0 +1,75 @@
+#pragma once
+
+#include <stdio.h>
+
+#include <algorithm>
+#include <chrono>
+#include <fstream>
+#include <iomanip>
+#include <iostream>
+#include <thread>
+#include <tuple>
+#include <vector>
+
+#include "pugixml.hpp"
+
+/* Headers for Windows */
+#if defined(_WIN32) || defined(_WIN64)
+#include <conio.h>
+
+#include "windows.h"
+
+#endif
+
+#include <stdio.h>
+
+#include <chrono>
+#include <cstring>
+#include <thread>
+
+#include "libps4000a/PicoStatus.h"
+#include "libps4000a/ps4000aApi.h"
+#include "pugiconfig.hpp"
+#include "pugixml.hpp"
+
+#define filename_xml "Pico_param.XML"
+
+using std::cout;
+using std::endl;
+using std::string;
+
+typedef std::tuple<string, int32_t, string, int32_t> Parse_data;
+
+uint32_t
+check(const string &);
+
+bool ShowParameterText(string, pugi::xml_node);
+
+string
+return_fun(uint32_t);
+
+Parse_data
+parse_xml_function(const char *);
+
+std::vector<uint32_t> string_to_vector(string);
+
+std::vector<PS4000A_CHANNEL>
+create_channel(const int32_t &);
+
+void
+writing_data(const std::vector<int16_t *> &, const int32_t, const int32_t);
+
+void writing_data_fixed_name(const std::string, const std::vector<int16_t*>&, const int32_t,
+                  const int32_t);
+
+void
+free_buffers(const std::vector<int16_t *> &);
+
+uint32_t
+timebase_choice(const int32_t);
+
+void
+set_data_buffer(const int32_t, const int32_t);
+
+void
+get_values();

BIN
pico-tcp-service/pico-tcp-client/picoipp.dll


BIN
pico-tcp-service/pico-tcp-client/ps4000a.dll


BIN
pico-tcp-service/pico-tcp-client/ps4000a.lib


+ 77 - 0
pico-tcp-service/pico-tcp-client/pugiconfig.hpp

@@ -0,0 +1,77 @@
+/**
+ * pugixml parser - version 1.14
+ * --------------------------------------------------------
+ * Copyright (C) 2006-2023, by Arseny Kapoulkine (arseny.kapoulkine@gmail.com)
+ * Report bugs and download new versions at https://pugixml.org/
+ *
+ * This library is distributed under the MIT License. See notice at the end
+ * of this file.
+ *
+ * This work is based on the pugxml parser, which is:
+ * Copyright (C) 2003, by Kristen Wegner (kristen@tima.net)
+ */
+
+#ifndef HEADER_PUGICONFIG_HPP
+#define HEADER_PUGICONFIG_HPP
+
+// Uncomment this to enable wchar_t mode
+// #define PUGIXML_WCHAR_MODE
+
+// Uncomment this to enable compact mode
+// #define PUGIXML_COMPACT
+
+// Uncomment this to disable XPath
+// #define PUGIXML_NO_XPATH
+
+// Uncomment this to disable STL
+// #define PUGIXML_NO_STL
+
+// Uncomment this to disable exceptions
+// #define PUGIXML_NO_EXCEPTIONS
+
+// Set this to control attributes for public classes/functions, i.e.:
+// #define PUGIXML_API __declspec(dllexport) // to export all public symbols from DLL
+// #define PUGIXML_CLASS __declspec(dllimport) // to import all classes from DLL
+// #define PUGIXML_FUNCTION __fastcall // to set calling conventions to all public functions to fastcall
+// In absence of PUGIXML_CLASS/PUGIXML_FUNCTION definitions PUGIXML_API is used instead
+
+// Tune these constants to adjust memory-related behavior
+// #define PUGIXML_MEMORY_PAGE_SIZE 32768
+// #define PUGIXML_MEMORY_OUTPUT_STACK 10240
+// #define PUGIXML_MEMORY_XPATH_PAGE_SIZE 4096
+
+// Tune this constant to adjust max nesting for XPath queries
+// #define PUGIXML_XPATH_DEPTH_LIMIT 1024
+
+// Uncomment this to switch to header-only version
+// #define PUGIXML_HEADER_ONLY
+
+// Uncomment this to enable long long support
+// #define PUGIXML_HAS_LONG_LONG
+
+#endif
+
+/**
+ * Copyright (c) 2006-2023 Arseny Kapoulkine
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */

+ 13226 - 0
pico-tcp-service/pico-tcp-client/pugixml.cpp

@@ -0,0 +1,13226 @@
+/**
+ * pugixml parser - version 1.14
+ * --------------------------------------------------------
+ * Copyright (C) 2006-2023, by Arseny Kapoulkine (arseny.kapoulkine@gmail.com)
+ * Report bugs and download new versions at https://pugixml.org/
+ *
+ * This library is distributed under the MIT License. See notice at the end
+ * of this file.
+ *
+ * This work is based on the pugxml parser, which is:
+ * Copyright (C) 2003, by Kristen Wegner (kristen@tima.net)
+ */
+
+#ifndef SOURCE_PUGIXML_CPP
+#define SOURCE_PUGIXML_CPP
+
+#include "pugixml.hpp"
+
+#include <stdlib.h>
+#include <stdio.h>
+#include <string.h>
+#include <assert.h>
+#include <limits.h>
+
+#ifdef PUGIXML_WCHAR_MODE
+#	include <wchar.h>
+#endif
+
+#ifndef PUGIXML_NO_XPATH
+#	include <math.h>
+#	include <float.h>
+#endif
+
+#ifndef PUGIXML_NO_STL
+#	include <istream>
+#	include <ostream>
+#	include <string>
+#endif
+
+// For placement new
+#include <new>
+
+// For load_file
+#if defined(__linux__) || defined(__APPLE__)
+#include <sys/stat.h>
+#endif
+
+#ifdef _MSC_VER
+#	pragma warning(push)
+#	pragma warning(disable: 4127) // conditional expression is constant
+#	pragma warning(disable: 4324) // structure was padded due to __declspec(align())
+#	pragma warning(disable: 4702) // unreachable code
+#	pragma warning(disable: 4996) // this function or variable may be unsafe
+#endif
+
+#if defined(_MSC_VER) && defined(__c2__)
+#	pragma clang diagnostic push
+#	pragma clang diagnostic ignored "-Wdeprecated" // this function or variable may be unsafe
+#endif
+
+#ifdef __INTEL_COMPILER
+#	pragma warning(disable: 177) // function was declared but never referenced
+#	pragma warning(disable: 279) // controlling expression is constant
+#	pragma warning(disable: 1478 1786) // function was declared "deprecated"
+#	pragma warning(disable: 1684) // conversion from pointer to same-sized integral type
+#endif
+
+#if defined(__BORLANDC__) && defined(PUGIXML_HEADER_ONLY)
+#	pragma warn -8080 // symbol is declared but never used; disabling this inside push/pop bracket does not make the warning go away
+#endif
+
+#ifdef __BORLANDC__
+#	pragma option push
+#	pragma warn -8008 // condition is always false
+#	pragma warn -8066 // unreachable code
+#endif
+
+#ifdef __SNC__
+// Using diag_push/diag_pop does not disable the warnings inside templates due to a compiler bug
+#	pragma diag_suppress=178 // function was declared but never referenced
+#	pragma diag_suppress=237 // controlling expression is constant
+#endif
+
+#ifdef __TI_COMPILER_VERSION__
+#	pragma diag_suppress 179 // function was declared but never referenced
+#endif
+
+// Inlining controls
+#if defined(_MSC_VER) && _MSC_VER >= 1300
+#	define PUGI_IMPL_NO_INLINE __declspec(noinline)
+#elif defined(__GNUC__)
+#	define PUGI_IMPL_NO_INLINE __attribute__((noinline))
+#else
+#	define PUGI_IMPL_NO_INLINE
+#endif
+
+// Branch weight controls
+#if defined(__GNUC__) && !defined(__c2__)
+#	define PUGI_IMPL_UNLIKELY(cond) __builtin_expect(cond, 0)
+#else
+#	define PUGI_IMPL_UNLIKELY(cond) (cond)
+#endif
+
+// Simple static assertion
+#define PUGI_IMPL_STATIC_ASSERT(cond) { static const char condition_failed[(cond) ? 1 : -1] = {0}; (void)condition_failed[0]; }
+
+// Digital Mars C++ bug workaround for passing char loaded from memory via stack
+#ifdef __DMC__
+#	define PUGI_IMPL_DMC_VOLATILE volatile
+#else
+#	define PUGI_IMPL_DMC_VOLATILE
+#endif
+
+// Integer sanitizer workaround; we only apply this for clang since gcc8 has no_sanitize but not unsigned-integer-overflow and produces "attribute directive ignored" warnings
+#if defined(__clang__) && defined(__has_attribute)
+#	if __has_attribute(no_sanitize)
+#		define PUGI_IMPL_UNSIGNED_OVERFLOW __attribute__((no_sanitize("unsigned-integer-overflow")))
+#	else
+#		define PUGI_IMPL_UNSIGNED_OVERFLOW
+#	endif
+#else
+#	define PUGI_IMPL_UNSIGNED_OVERFLOW
+#endif
+
+// Borland C++ bug workaround for not defining ::memcpy depending on header include order (can't always use std::memcpy because some compilers don't have it at all)
+#if defined(__BORLANDC__) && !defined(__MEM_H_USING_LIST)
+using std::memcpy;
+using std::memmove;
+using std::memset;
+#endif
+
+// Old versions of GCC do not define ::malloc and ::free depending on header include order
+#if defined(__GNUC__) && (__GNUC__ < 3 || (__GNUC__ == 3 && __GNUC_MINOR__ < 4))
+using std::malloc;
+using std::free;
+#endif
+
+// Some MinGW/GCC versions have headers that erroneously omit LLONG_MIN/LLONG_MAX/ULLONG_MAX definitions from limits.h in some configurations
+#if defined(PUGIXML_HAS_LONG_LONG) && defined(__GNUC__) && !defined(LLONG_MAX) && !defined(LLONG_MIN) && !defined(ULLONG_MAX)
+#	define LLONG_MIN (-LLONG_MAX - 1LL)
+#	define LLONG_MAX __LONG_LONG_MAX__
+#	define ULLONG_MAX (LLONG_MAX * 2ULL + 1ULL)
+#endif
+
+// In some environments MSVC is a compiler but the CRT lacks certain MSVC-specific features
+#if defined(_MSC_VER) && !defined(__S3E__) && !defined(_WIN32_WCE)
+#	define PUGI_IMPL_MSVC_CRT_VERSION _MSC_VER
+#elif defined(_WIN32_WCE)
+#	define PUGI_IMPL_MSVC_CRT_VERSION 1310 // MSVC7.1
+#endif
+
+// Not all platforms have snprintf; we define a wrapper that uses snprintf if possible. This only works with buffers with a known size.
+#if __cplusplus >= 201103
+#	define PUGI_IMPL_SNPRINTF(buf, ...) snprintf(buf, sizeof(buf), __VA_ARGS__)
+#elif defined(PUGI_IMPL_MSVC_CRT_VERSION) && PUGI_IMPL_MSVC_CRT_VERSION >= 1400
+#	define PUGI_IMPL_SNPRINTF(buf, ...) _snprintf_s(buf, _countof(buf), _TRUNCATE, __VA_ARGS__)
+#elif defined(__APPLE__) && __clang_major__ >= 14 // Xcode 14 marks sprintf as deprecated while still using C++98 by default
+#	define PUGI_IMPL_SNPRINTF(buf, fmt, arg1, arg2) snprintf(buf, sizeof(buf), fmt, arg1, arg2)
+#else
+#	define PUGI_IMPL_SNPRINTF sprintf
+#endif
+
+// We put implementation details into an anonymous namespace in source mode, but have to keep it in non-anonymous namespace in header-only mode to prevent binary bloat.
+#ifdef PUGIXML_HEADER_ONLY
+#	define PUGI_IMPL_NS_BEGIN namespace pugi { namespace impl {
+#	define PUGI_IMPL_NS_END } }
+#	define PUGI_IMPL_FN inline
+#	define PUGI_IMPL_FN_NO_INLINE inline
+#else
+#	if defined(_MSC_VER) && _MSC_VER < 1300 // MSVC6 seems to have an amusing bug with anonymous namespaces inside namespaces
+#		define PUGI_IMPL_NS_BEGIN namespace pugi { namespace impl {
+#		define PUGI_IMPL_NS_END } }
+#	else
+#		define PUGI_IMPL_NS_BEGIN namespace pugi { namespace impl { namespace {
+#		define PUGI_IMPL_NS_END } } }
+#	endif
+#	define PUGI_IMPL_FN
+#	define PUGI_IMPL_FN_NO_INLINE PUGI_IMPL_NO_INLINE
+#endif
+
+// uintptr_t
+#if (defined(_MSC_VER) && _MSC_VER < 1600) || (defined(__BORLANDC__) && __BORLANDC__ < 0x561)
+namespace pugi
+{
+#	ifndef _UINTPTR_T_DEFINED
+	typedef size_t uintptr_t;
+#	endif
+
+	typedef unsigned __int8 uint8_t;
+	typedef unsigned __int16 uint16_t;
+	typedef unsigned __int32 uint32_t;
+}
+#else
+#	include <stdint.h>
+#endif
+
+// Memory allocation
+PUGI_IMPL_NS_BEGIN
+	PUGI_IMPL_FN void* default_allocate(size_t size)
+	{
+		return malloc(size);
+	}
+
+	PUGI_IMPL_FN void default_deallocate(void* ptr)
+	{
+		free(ptr);
+	}
+
+	template <typename T>
+	struct xml_memory_management_function_storage
+	{
+		static allocation_function allocate;
+		static deallocation_function deallocate;
+	};
+
+	// Global allocation functions are stored in class statics so that in header mode linker deduplicates them
+	// Without a template<> we'll get multiple definitions of the same static
+	template <typename T> allocation_function xml_memory_management_function_storage<T>::allocate = default_allocate;
+	template <typename T> deallocation_function xml_memory_management_function_storage<T>::deallocate = default_deallocate;
+
+	typedef xml_memory_management_function_storage<int> xml_memory;
+PUGI_IMPL_NS_END
+
+// String utilities
+PUGI_IMPL_NS_BEGIN
+	// Get string length
+	PUGI_IMPL_FN size_t strlength(const char_t* s)
+	{
+		assert(s);
+
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcslen(s);
+	#else
+		return strlen(s);
+	#endif
+	}
+
+	// Compare two strings
+	PUGI_IMPL_FN bool strequal(const char_t* src, const char_t* dst)
+	{
+		assert(src && dst);
+
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcscmp(src, dst) == 0;
+	#else
+		return strcmp(src, dst) == 0;
+	#endif
+	}
+
+	// Compare lhs with [rhs_begin, rhs_end)
+	PUGI_IMPL_FN bool strequalrange(const char_t* lhs, const char_t* rhs, size_t count)
+	{
+		for (size_t i = 0; i < count; ++i)
+			if (lhs[i] != rhs[i])
+				return false;
+
+		return lhs[count] == 0;
+	}
+
+	// Get length of wide string, even if CRT lacks wide character support
+	PUGI_IMPL_FN size_t strlength_wide(const wchar_t* s)
+	{
+		assert(s);
+
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcslen(s);
+	#else
+		const wchar_t* end = s;
+		while (*end) end++;
+		return static_cast<size_t>(end - s);
+	#endif
+	}
+PUGI_IMPL_NS_END
+
+// auto_ptr-like object for exception recovery
+PUGI_IMPL_NS_BEGIN
+	template <typename T> struct auto_deleter
+	{
+		typedef void (*D)(T*);
+
+		T* data;
+		D deleter;
+
+		auto_deleter(T* data_, D deleter_): data(data_), deleter(deleter_)
+		{
+		}
+
+		~auto_deleter()
+		{
+			if (data) deleter(data);
+		}
+
+		T* release()
+		{
+			T* result = data;
+			data = 0;
+			return result;
+		}
+	};
+PUGI_IMPL_NS_END
+
+#ifdef PUGIXML_COMPACT
+PUGI_IMPL_NS_BEGIN
+	class compact_hash_table
+	{
+	public:
+		compact_hash_table(): _items(0), _capacity(0), _count(0)
+		{
+		}
+
+		void clear()
+		{
+			if (_items)
+			{
+				xml_memory::deallocate(_items);
+				_items = 0;
+				_capacity = 0;
+				_count = 0;
+			}
+		}
+
+		void* find(const void* key)
+		{
+			if (_capacity == 0) return 0;
+
+			item_t* item = get_item(key);
+			assert(item);
+			assert(item->key == key || (item->key == 0 && item->value == 0));
+
+			return item->value;
+		}
+
+		void insert(const void* key, void* value)
+		{
+			assert(_capacity != 0 && _count < _capacity - _capacity / 4);
+
+			item_t* item = get_item(key);
+			assert(item);
+
+			if (item->key == 0)
+			{
+				_count++;
+				item->key = key;
+			}
+
+			item->value = value;
+		}
+
+		bool reserve(size_t extra = 16)
+		{
+			if (_count + extra >= _capacity - _capacity / 4)
+				return rehash(_count + extra);
+
+			return true;
+		}
+
+	private:
+		struct item_t
+		{
+			const void* key;
+			void* value;
+		};
+
+		item_t* _items;
+		size_t _capacity;
+
+		size_t _count;
+
+		bool rehash(size_t count);
+
+		item_t* get_item(const void* key)
+		{
+			assert(key);
+			assert(_capacity > 0);
+
+			size_t hashmod = _capacity - 1;
+			size_t bucket = hash(key) & hashmod;
+
+			for (size_t probe = 0; probe <= hashmod; ++probe)
+			{
+				item_t& probe_item = _items[bucket];
+
+				if (probe_item.key == key || probe_item.key == 0)
+					return &probe_item;
+
+				// hash collision, quadratic probing
+				bucket = (bucket + probe + 1) & hashmod;
+			}
+
+			assert(false && "Hash table is full"); // unreachable
+			return 0;
+		}
+
+		static PUGI_IMPL_UNSIGNED_OVERFLOW unsigned int hash(const void* key)
+		{
+			unsigned int h = static_cast<unsigned int>(reinterpret_cast<uintptr_t>(key) & 0xffffffff);
+
+			// MurmurHash3 32-bit finalizer
+			h ^= h >> 16;
+			h *= 0x85ebca6bu;
+			h ^= h >> 13;
+			h *= 0xc2b2ae35u;
+			h ^= h >> 16;
+
+			return h;
+		}
+	};
+
+	PUGI_IMPL_FN_NO_INLINE bool compact_hash_table::rehash(size_t count)
+	{
+		size_t capacity = 32;
+		while (count >= capacity - capacity / 4)
+			capacity *= 2;
+
+		compact_hash_table rt;
+		rt._capacity = capacity;
+		rt._items = static_cast<item_t*>(xml_memory::allocate(sizeof(item_t) * capacity));
+
+		if (!rt._items)
+			return false;
+
+		memset(rt._items, 0, sizeof(item_t) * capacity);
+
+		for (size_t i = 0; i < _capacity; ++i)
+			if (_items[i].key)
+				rt.insert(_items[i].key, _items[i].value);
+
+		if (_items)
+			xml_memory::deallocate(_items);
+
+		_capacity = capacity;
+		_items = rt._items;
+
+		assert(_count == rt._count);
+
+		return true;
+	}
+
+PUGI_IMPL_NS_END
+#endif
+
+PUGI_IMPL_NS_BEGIN
+#ifdef PUGIXML_COMPACT
+	static const uintptr_t xml_memory_block_alignment = 4;
+#else
+	static const uintptr_t xml_memory_block_alignment = sizeof(void*);
+#endif
+
+	// extra metadata bits
+	static const uintptr_t xml_memory_page_contents_shared_mask = 64;
+	static const uintptr_t xml_memory_page_name_allocated_mask = 32;
+	static const uintptr_t xml_memory_page_value_allocated_mask = 16;
+	static const uintptr_t xml_memory_page_type_mask = 15;
+
+	// combined masks for string uniqueness
+	static const uintptr_t xml_memory_page_name_allocated_or_shared_mask = xml_memory_page_name_allocated_mask | xml_memory_page_contents_shared_mask;
+	static const uintptr_t xml_memory_page_value_allocated_or_shared_mask = xml_memory_page_value_allocated_mask | xml_memory_page_contents_shared_mask;
+
+#ifdef PUGIXML_COMPACT
+	#define PUGI_IMPL_GETHEADER_IMPL(object, page, flags) // unused
+	#define PUGI_IMPL_GETPAGE_IMPL(header) (header).get_page()
+#else
+	#define PUGI_IMPL_GETHEADER_IMPL(object, page, flags) (((reinterpret_cast<char*>(object) - reinterpret_cast<char*>(page)) << 8) | (flags))
+	// this macro casts pointers through void* to avoid 'cast increases required alignment of target type' warnings
+	#define PUGI_IMPL_GETPAGE_IMPL(header) static_cast<impl::xml_memory_page*>(const_cast<void*>(static_cast<const void*>(reinterpret_cast<const char*>(&header) - (header >> 8))))
+#endif
+
+	#define PUGI_IMPL_GETPAGE(n) PUGI_IMPL_GETPAGE_IMPL((n)->header)
+	#define PUGI_IMPL_NODETYPE(n) static_cast<xml_node_type>((n)->header & impl::xml_memory_page_type_mask)
+
+	struct xml_allocator;
+
+	struct xml_memory_page
+	{
+		static xml_memory_page* construct(void* memory)
+		{
+			xml_memory_page* result = static_cast<xml_memory_page*>(memory);
+
+			result->allocator = 0;
+			result->prev = 0;
+			result->next = 0;
+			result->busy_size = 0;
+			result->freed_size = 0;
+
+		#ifdef PUGIXML_COMPACT
+			result->compact_string_base = 0;
+			result->compact_shared_parent = 0;
+			result->compact_page_marker = 0;
+		#endif
+
+			return result;
+		}
+
+		xml_allocator* allocator;
+
+		xml_memory_page* prev;
+		xml_memory_page* next;
+
+		size_t busy_size;
+		size_t freed_size;
+
+	#ifdef PUGIXML_COMPACT
+		char_t* compact_string_base;
+		void* compact_shared_parent;
+		uint32_t* compact_page_marker;
+	#endif
+	};
+
+	static const size_t xml_memory_page_size =
+	#ifdef PUGIXML_MEMORY_PAGE_SIZE
+		(PUGIXML_MEMORY_PAGE_SIZE)
+	#else
+		32768
+	#endif
+		- sizeof(xml_memory_page);
+
+	struct xml_memory_string_header
+	{
+		uint16_t page_offset; // offset from page->data
+		uint16_t full_size; // 0 if string occupies whole page
+	};
+
+	struct xml_allocator
+	{
+		xml_allocator(xml_memory_page* root): _root(root), _busy_size(root->busy_size)
+		{
+		#ifdef PUGIXML_COMPACT
+			_hash = 0;
+		#endif
+		}
+
+		xml_memory_page* allocate_page(size_t data_size)
+		{
+			size_t size = sizeof(xml_memory_page) + data_size;
+
+			// allocate block with some alignment, leaving memory for worst-case padding
+			void* memory = xml_memory::allocate(size);
+			if (!memory) return 0;
+
+			// prepare page structure
+			xml_memory_page* page = xml_memory_page::construct(memory);
+			assert(page);
+
+			assert(this == _root->allocator);
+			page->allocator = this;
+
+			return page;
+		}
+
+		static void deallocate_page(xml_memory_page* page)
+		{
+			xml_memory::deallocate(page);
+		}
+
+		void* allocate_memory_oob(size_t size, xml_memory_page*& out_page);
+
+		void* allocate_memory(size_t size, xml_memory_page*& out_page)
+		{
+			if (PUGI_IMPL_UNLIKELY(_busy_size + size > xml_memory_page_size))
+				return allocate_memory_oob(size, out_page);
+
+			void* buf = reinterpret_cast<char*>(_root) + sizeof(xml_memory_page) + _busy_size;
+
+			_busy_size += size;
+
+			out_page = _root;
+
+			return buf;
+		}
+
+	#ifdef PUGIXML_COMPACT
+		void* allocate_object(size_t size, xml_memory_page*& out_page)
+		{
+			void* result = allocate_memory(size + sizeof(uint32_t), out_page);
+			if (!result) return 0;
+
+			// adjust for marker
+			ptrdiff_t offset = static_cast<char*>(result) - reinterpret_cast<char*>(out_page->compact_page_marker);
+
+			if (PUGI_IMPL_UNLIKELY(static_cast<uintptr_t>(offset) >= 256 * xml_memory_block_alignment))
+			{
+				// insert new marker
+				uint32_t* marker = static_cast<uint32_t*>(result);
+
+				*marker = static_cast<uint32_t>(reinterpret_cast<char*>(marker) - reinterpret_cast<char*>(out_page));
+				out_page->compact_page_marker = marker;
+
+				// since we don't reuse the page space until we reallocate it, we can just pretend that we freed the marker block
+				// this will make sure deallocate_memory correctly tracks the size
+				out_page->freed_size += sizeof(uint32_t);
+
+				return marker + 1;
+			}
+			else
+			{
+				// roll back uint32_t part
+				_busy_size -= sizeof(uint32_t);
+
+				return result;
+			}
+		}
+	#else
+		void* allocate_object(size_t size, xml_memory_page*& out_page)
+		{
+			return allocate_memory(size, out_page);
+		}
+	#endif
+
+		void deallocate_memory(void* ptr, size_t size, xml_memory_page* page)
+		{
+			if (page == _root) page->busy_size = _busy_size;
+
+			assert(ptr >= reinterpret_cast<char*>(page) + sizeof(xml_memory_page) && ptr < reinterpret_cast<char*>(page) + sizeof(xml_memory_page) + page->busy_size);
+			(void)!ptr;
+
+			page->freed_size += size;
+			assert(page->freed_size <= page->busy_size);
+
+			if (page->freed_size == page->busy_size)
+			{
+				if (page->next == 0)
+				{
+					assert(_root == page);
+
+					// top page freed, just reset sizes
+					page->busy_size = 0;
+					page->freed_size = 0;
+
+				#ifdef PUGIXML_COMPACT
+					// reset compact state to maximize efficiency
+					page->compact_string_base = 0;
+					page->compact_shared_parent = 0;
+					page->compact_page_marker = 0;
+				#endif
+
+					_busy_size = 0;
+				}
+				else
+				{
+					assert(_root != page);
+					assert(page->prev);
+
+					// remove from the list
+					page->prev->next = page->next;
+					page->next->prev = page->prev;
+
+					// deallocate
+					deallocate_page(page);
+				}
+			}
+		}
+
+		char_t* allocate_string(size_t length)
+		{
+			static const size_t max_encoded_offset = (1 << 16) * xml_memory_block_alignment;
+
+			PUGI_IMPL_STATIC_ASSERT(xml_memory_page_size <= max_encoded_offset);
+
+			// allocate memory for string and header block
+			size_t size = sizeof(xml_memory_string_header) + length * sizeof(char_t);
+
+			// round size up to block alignment boundary
+			size_t full_size = (size + (xml_memory_block_alignment - 1)) & ~(xml_memory_block_alignment - 1);
+
+			xml_memory_page* page;
+			xml_memory_string_header* header = static_cast<xml_memory_string_header*>(allocate_memory(full_size, page));
+
+			if (!header) return 0;
+
+			// setup header
+			ptrdiff_t page_offset = reinterpret_cast<char*>(header) - reinterpret_cast<char*>(page) - sizeof(xml_memory_page);
+
+			assert(page_offset % xml_memory_block_alignment == 0);
+			assert(page_offset >= 0 && static_cast<size_t>(page_offset) < max_encoded_offset);
+			header->page_offset = static_cast<uint16_t>(static_cast<size_t>(page_offset) / xml_memory_block_alignment);
+
+			// full_size == 0 for large strings that occupy the whole page
+			assert(full_size % xml_memory_block_alignment == 0);
+			assert(full_size < max_encoded_offset || (page->busy_size == full_size && page_offset == 0));
+			header->full_size = static_cast<uint16_t>(full_size < max_encoded_offset ? full_size / xml_memory_block_alignment : 0);
+
+			// round-trip through void* to avoid 'cast increases required alignment of target type' warning
+			// header is guaranteed a pointer-sized alignment, which should be enough for char_t
+			return static_cast<char_t*>(static_cast<void*>(header + 1));
+		}
+
+		void deallocate_string(char_t* string)
+		{
+			// this function casts pointers through void* to avoid 'cast increases required alignment of target type' warnings
+			// we're guaranteed the proper (pointer-sized) alignment on the input string if it was allocated via allocate_string
+
+			// get header
+			xml_memory_string_header* header = static_cast<xml_memory_string_header*>(static_cast<void*>(string)) - 1;
+			assert(header);
+
+			// deallocate
+			size_t page_offset = sizeof(xml_memory_page) + header->page_offset * xml_memory_block_alignment;
+			xml_memory_page* page = reinterpret_cast<xml_memory_page*>(static_cast<void*>(reinterpret_cast<char*>(header) - page_offset));
+
+			// if full_size == 0 then this string occupies the whole page
+			size_t full_size = header->full_size == 0 ? page->busy_size : header->full_size * xml_memory_block_alignment;
+
+			deallocate_memory(header, full_size, page);
+		}
+
+		bool reserve()
+		{
+		#ifdef PUGIXML_COMPACT
+			return _hash->reserve();
+		#else
+			return true;
+		#endif
+		}
+
+		xml_memory_page* _root;
+		size_t _busy_size;
+
+	#ifdef PUGIXML_COMPACT
+		compact_hash_table* _hash;
+	#endif
+	};
+
+	PUGI_IMPL_FN_NO_INLINE void* xml_allocator::allocate_memory_oob(size_t size, xml_memory_page*& out_page)
+	{
+		const size_t large_allocation_threshold = xml_memory_page_size / 4;
+
+		xml_memory_page* page = allocate_page(size <= large_allocation_threshold ? xml_memory_page_size : size);
+		out_page = page;
+
+		if (!page) return 0;
+
+		if (size <= large_allocation_threshold)
+		{
+			_root->busy_size = _busy_size;
+
+			// insert page at the end of linked list
+			page->prev = _root;
+			_root->next = page;
+			_root = page;
+
+			_busy_size = size;
+		}
+		else
+		{
+			// insert page before the end of linked list, so that it is deleted as soon as possible
+			// the last page is not deleted even if it's empty (see deallocate_memory)
+			assert(_root->prev);
+
+			page->prev = _root->prev;
+			page->next = _root;
+
+			_root->prev->next = page;
+			_root->prev = page;
+
+			page->busy_size = size;
+		}
+
+		return reinterpret_cast<char*>(page) + sizeof(xml_memory_page);
+	}
+PUGI_IMPL_NS_END
+
+#ifdef PUGIXML_COMPACT
+PUGI_IMPL_NS_BEGIN
+	static const uintptr_t compact_alignment_log2 = 2;
+	static const uintptr_t compact_alignment = 1 << compact_alignment_log2;
+
+	class compact_header
+	{
+	public:
+		compact_header(xml_memory_page* page, unsigned int flags)
+		{
+			PUGI_IMPL_STATIC_ASSERT(xml_memory_block_alignment == compact_alignment);
+
+			ptrdiff_t offset = (reinterpret_cast<char*>(this) - reinterpret_cast<char*>(page->compact_page_marker));
+			assert(offset % compact_alignment == 0 && static_cast<uintptr_t>(offset) < 256 * compact_alignment);
+
+			_page = static_cast<unsigned char>(offset >> compact_alignment_log2);
+			_flags = static_cast<unsigned char>(flags);
+		}
+
+		void operator&=(uintptr_t mod)
+		{
+			_flags &= static_cast<unsigned char>(mod);
+		}
+
+		void operator|=(uintptr_t mod)
+		{
+			_flags |= static_cast<unsigned char>(mod);
+		}
+
+		uintptr_t operator&(uintptr_t mod) const
+		{
+			return _flags & mod;
+		}
+
+		xml_memory_page* get_page() const
+		{
+			// round-trip through void* to silence 'cast increases required alignment of target type' warnings
+			const char* page_marker = reinterpret_cast<const char*>(this) - (_page << compact_alignment_log2);
+			const char* page = page_marker - *reinterpret_cast<const uint32_t*>(static_cast<const void*>(page_marker));
+
+			return const_cast<xml_memory_page*>(reinterpret_cast<const xml_memory_page*>(static_cast<const void*>(page)));
+		}
+
+	private:
+		unsigned char _page;
+		unsigned char _flags;
+	};
+
+	PUGI_IMPL_FN xml_memory_page* compact_get_page(const void* object, int header_offset)
+	{
+		const compact_header* header = reinterpret_cast<const compact_header*>(static_cast<const char*>(object) - header_offset);
+
+		return header->get_page();
+	}
+
+	template <int header_offset, typename T> PUGI_IMPL_FN_NO_INLINE T* compact_get_value(const void* object)
+	{
+		return static_cast<T*>(compact_get_page(object, header_offset)->allocator->_hash->find(object));
+	}
+
+	template <int header_offset, typename T> PUGI_IMPL_FN_NO_INLINE void compact_set_value(const void* object, T* value)
+	{
+		compact_get_page(object, header_offset)->allocator->_hash->insert(object, value);
+	}
+
+	template <typename T, int header_offset, int start = -126> class compact_pointer
+	{
+	public:
+		compact_pointer(): _data(0)
+		{
+		}
+
+		void operator=(const compact_pointer& rhs)
+		{
+			*this = rhs + 0;
+		}
+
+		void operator=(T* value)
+		{
+			if (value)
+			{
+				// value is guaranteed to be compact-aligned; 'this' is not
+				// our decoding is based on 'this' aligned to compact alignment downwards (see operator T*)
+				// so for negative offsets (e.g. -3) we need to adjust the diff by compact_alignment - 1 to
+				// compensate for arithmetic shift rounding for negative values
+				ptrdiff_t diff = reinterpret_cast<char*>(value) - reinterpret_cast<char*>(this);
+				ptrdiff_t offset = ((diff + int(compact_alignment - 1)) >> compact_alignment_log2) - start;
+
+				if (static_cast<uintptr_t>(offset) <= 253)
+					_data = static_cast<unsigned char>(offset + 1);
+				else
+				{
+					compact_set_value<header_offset>(this, value);
+
+					_data = 255;
+				}
+			}
+			else
+				_data = 0;
+		}
+
+		operator T*() const
+		{
+			if (_data)
+			{
+				if (_data < 255)
+				{
+					uintptr_t base = reinterpret_cast<uintptr_t>(this) & ~(compact_alignment - 1);
+
+					return reinterpret_cast<T*>(base + (_data - 1 + start) * compact_alignment);
+				}
+				else
+					return compact_get_value<header_offset, T>(this);
+			}
+			else
+				return 0;
+		}
+
+		T* operator->() const
+		{
+			return *this;
+		}
+
+	private:
+		unsigned char _data;
+	};
+
+	template <typename T, int header_offset> class compact_pointer_parent
+	{
+	public:
+		compact_pointer_parent(): _data(0)
+		{
+		}
+
+		void operator=(const compact_pointer_parent& rhs)
+		{
+			*this = rhs + 0;
+		}
+
+		void operator=(T* value)
+		{
+			if (value)
+			{
+				// value is guaranteed to be compact-aligned; 'this' is not
+				// our decoding is based on 'this' aligned to compact alignment downwards (see operator T*)
+				// so for negative offsets (e.g. -3) we need to adjust the diff by compact_alignment - 1 to
+				// compensate for arithmetic shift behavior for negative values
+				ptrdiff_t diff = reinterpret_cast<char*>(value) - reinterpret_cast<char*>(this);
+				ptrdiff_t offset = ((diff + int(compact_alignment - 1)) >> compact_alignment_log2) + 65533;
+
+				if (static_cast<uintptr_t>(offset) <= 65533)
+				{
+					_data = static_cast<unsigned short>(offset + 1);
+				}
+				else
+				{
+					xml_memory_page* page = compact_get_page(this, header_offset);
+
+					if (PUGI_IMPL_UNLIKELY(page->compact_shared_parent == 0))
+						page->compact_shared_parent = value;
+
+					if (page->compact_shared_parent == value)
+					{
+						_data = 65534;
+					}
+					else
+					{
+						compact_set_value<header_offset>(this, value);
+
+						_data = 65535;
+					}
+				}
+			}
+			else
+			{
+				_data = 0;
+			}
+		}
+
+		operator T*() const
+		{
+			if (_data)
+			{
+				if (_data < 65534)
+				{
+					uintptr_t base = reinterpret_cast<uintptr_t>(this) & ~(compact_alignment - 1);
+
+					return reinterpret_cast<T*>(base + (_data - 1 - 65533) * compact_alignment);
+				}
+				else if (_data == 65534)
+					return static_cast<T*>(compact_get_page(this, header_offset)->compact_shared_parent);
+				else
+					return compact_get_value<header_offset, T>(this);
+			}
+			else
+				return 0;
+		}
+
+		T* operator->() const
+		{
+			return *this;
+		}
+
+	private:
+		uint16_t _data;
+	};
+
+	template <int header_offset, int base_offset> class compact_string
+	{
+	public:
+		compact_string(): _data(0)
+		{
+		}
+
+		void operator=(const compact_string& rhs)
+		{
+			*this = rhs + 0;
+		}
+
+		void operator=(char_t* value)
+		{
+			if (value)
+			{
+				xml_memory_page* page = compact_get_page(this, header_offset);
+
+				if (PUGI_IMPL_UNLIKELY(page->compact_string_base == 0))
+					page->compact_string_base = value;
+
+				ptrdiff_t offset = value - page->compact_string_base;
+
+				if (static_cast<uintptr_t>(offset) < (65535 << 7))
+				{
+					// round-trip through void* to silence 'cast increases required alignment of target type' warnings
+					uint16_t* base = reinterpret_cast<uint16_t*>(static_cast<void*>(reinterpret_cast<char*>(this) - base_offset));
+
+					if (*base == 0)
+					{
+						*base = static_cast<uint16_t>((offset >> 7) + 1);
+						_data = static_cast<unsigned char>((offset & 127) + 1);
+					}
+					else
+					{
+						ptrdiff_t remainder = offset - ((*base - 1) << 7);
+
+						if (static_cast<uintptr_t>(remainder) <= 253)
+						{
+							_data = static_cast<unsigned char>(remainder + 1);
+						}
+						else
+						{
+							compact_set_value<header_offset>(this, value);
+
+							_data = 255;
+						}
+					}
+				}
+				else
+				{
+					compact_set_value<header_offset>(this, value);
+
+					_data = 255;
+				}
+			}
+			else
+			{
+				_data = 0;
+			}
+		}
+
+		operator char_t*() const
+		{
+			if (_data)
+			{
+				if (_data < 255)
+				{
+					xml_memory_page* page = compact_get_page(this, header_offset);
+
+					// round-trip through void* to silence 'cast increases required alignment of target type' warnings
+					const uint16_t* base = reinterpret_cast<const uint16_t*>(static_cast<const void*>(reinterpret_cast<const char*>(this) - base_offset));
+					assert(*base);
+
+					ptrdiff_t offset = ((*base - 1) << 7) + (_data - 1);
+
+					return page->compact_string_base + offset;
+				}
+				else
+				{
+					return compact_get_value<header_offset, char_t>(this);
+				}
+			}
+			else
+				return 0;
+		}
+
+	private:
+		unsigned char _data;
+	};
+PUGI_IMPL_NS_END
+#endif
+
+#ifdef PUGIXML_COMPACT
+namespace pugi
+{
+	struct xml_attribute_struct
+	{
+		xml_attribute_struct(impl::xml_memory_page* page): header(page, 0), namevalue_base(0)
+		{
+			PUGI_IMPL_STATIC_ASSERT(sizeof(xml_attribute_struct) == 8);
+		}
+
+		impl::compact_header header;
+
+		uint16_t namevalue_base;
+
+		impl::compact_string<4, 2> name;
+		impl::compact_string<5, 3> value;
+
+		impl::compact_pointer<xml_attribute_struct, 6> prev_attribute_c;
+		impl::compact_pointer<xml_attribute_struct, 7, 0> next_attribute;
+	};
+
+	struct xml_node_struct
+	{
+		xml_node_struct(impl::xml_memory_page* page, xml_node_type type): header(page, type), namevalue_base(0)
+		{
+			PUGI_IMPL_STATIC_ASSERT(sizeof(xml_node_struct) == 12);
+		}
+
+		impl::compact_header header;
+
+		uint16_t namevalue_base;
+
+		impl::compact_string<4, 2> name;
+		impl::compact_string<5, 3> value;
+
+		impl::compact_pointer_parent<xml_node_struct, 6> parent;
+
+		impl::compact_pointer<xml_node_struct, 8, 0> first_child;
+
+		impl::compact_pointer<xml_node_struct,  9>    prev_sibling_c;
+		impl::compact_pointer<xml_node_struct, 10, 0> next_sibling;
+
+		impl::compact_pointer<xml_attribute_struct, 11, 0> first_attribute;
+	};
+}
+#else
+namespace pugi
+{
+	struct xml_attribute_struct
+	{
+		xml_attribute_struct(impl::xml_memory_page* page): name(0), value(0), prev_attribute_c(0), next_attribute(0)
+		{
+			header = PUGI_IMPL_GETHEADER_IMPL(this, page, 0);
+		}
+
+		uintptr_t header;
+
+		char_t*	name;
+		char_t*	value;
+
+		xml_attribute_struct* prev_attribute_c;
+		xml_attribute_struct* next_attribute;
+	};
+
+	struct xml_node_struct
+	{
+		xml_node_struct(impl::xml_memory_page* page, xml_node_type type): name(0), value(0), parent(0), first_child(0), prev_sibling_c(0), next_sibling(0), first_attribute(0)
+		{
+			header = PUGI_IMPL_GETHEADER_IMPL(this, page, type);
+		}
+
+		uintptr_t header;
+
+		char_t* name;
+		char_t* value;
+
+		xml_node_struct* parent;
+
+		xml_node_struct* first_child;
+
+		xml_node_struct* prev_sibling_c;
+		xml_node_struct* next_sibling;
+
+		xml_attribute_struct* first_attribute;
+	};
+}
+#endif
+
+PUGI_IMPL_NS_BEGIN
+	struct xml_extra_buffer
+	{
+		char_t* buffer;
+		xml_extra_buffer* next;
+	};
+
+	struct xml_document_struct: public xml_node_struct, public xml_allocator
+	{
+		xml_document_struct(xml_memory_page* page): xml_node_struct(page, node_document), xml_allocator(page), buffer(0), extra_buffers(0)
+		{
+		}
+
+		const char_t* buffer;
+
+		xml_extra_buffer* extra_buffers;
+
+	#ifdef PUGIXML_COMPACT
+		compact_hash_table hash;
+	#endif
+	};
+
+	template <typename Object> inline xml_allocator& get_allocator(const Object* object)
+	{
+		assert(object);
+
+		return *PUGI_IMPL_GETPAGE(object)->allocator;
+	}
+
+	template <typename Object> inline xml_document_struct& get_document(const Object* object)
+	{
+		assert(object);
+
+		return *static_cast<xml_document_struct*>(PUGI_IMPL_GETPAGE(object)->allocator);
+	}
+PUGI_IMPL_NS_END
+
+// Low-level DOM operations
+PUGI_IMPL_NS_BEGIN
+	inline xml_attribute_struct* allocate_attribute(xml_allocator& alloc)
+	{
+		xml_memory_page* page;
+		void* memory = alloc.allocate_object(sizeof(xml_attribute_struct), page);
+		if (!memory) return 0;
+
+		return new (memory) xml_attribute_struct(page);
+	}
+
+	inline xml_node_struct* allocate_node(xml_allocator& alloc, xml_node_type type)
+	{
+		xml_memory_page* page;
+		void* memory = alloc.allocate_object(sizeof(xml_node_struct), page);
+		if (!memory) return 0;
+
+		return new (memory) xml_node_struct(page, type);
+	}
+
+	inline void destroy_attribute(xml_attribute_struct* a, xml_allocator& alloc)
+	{
+		if (a->header & impl::xml_memory_page_name_allocated_mask)
+			alloc.deallocate_string(a->name);
+
+		if (a->header & impl::xml_memory_page_value_allocated_mask)
+			alloc.deallocate_string(a->value);
+
+		alloc.deallocate_memory(a, sizeof(xml_attribute_struct), PUGI_IMPL_GETPAGE(a));
+	}
+
+	inline void destroy_node(xml_node_struct* n, xml_allocator& alloc)
+	{
+		if (n->header & impl::xml_memory_page_name_allocated_mask)
+			alloc.deallocate_string(n->name);
+
+		if (n->header & impl::xml_memory_page_value_allocated_mask)
+			alloc.deallocate_string(n->value);
+
+		for (xml_attribute_struct* attr = n->first_attribute; attr; )
+		{
+			xml_attribute_struct* next = attr->next_attribute;
+
+			destroy_attribute(attr, alloc);
+
+			attr = next;
+		}
+
+		for (xml_node_struct* child = n->first_child; child; )
+		{
+			xml_node_struct* next = child->next_sibling;
+
+			destroy_node(child, alloc);
+
+			child = next;
+		}
+
+		alloc.deallocate_memory(n, sizeof(xml_node_struct), PUGI_IMPL_GETPAGE(n));
+	}
+
+	inline void append_node(xml_node_struct* child, xml_node_struct* node)
+	{
+		child->parent = node;
+
+		xml_node_struct* head = node->first_child;
+
+		if (head)
+		{
+			xml_node_struct* tail = head->prev_sibling_c;
+
+			tail->next_sibling = child;
+			child->prev_sibling_c = tail;
+			head->prev_sibling_c = child;
+		}
+		else
+		{
+			node->first_child = child;
+			child->prev_sibling_c = child;
+		}
+	}
+
+	inline void prepend_node(xml_node_struct* child, xml_node_struct* node)
+	{
+		child->parent = node;
+
+		xml_node_struct* head = node->first_child;
+
+		if (head)
+		{
+			child->prev_sibling_c = head->prev_sibling_c;
+			head->prev_sibling_c = child;
+		}
+		else
+			child->prev_sibling_c = child;
+
+		child->next_sibling = head;
+		node->first_child = child;
+	}
+
+	inline void insert_node_after(xml_node_struct* child, xml_node_struct* node)
+	{
+		xml_node_struct* parent = node->parent;
+
+		child->parent = parent;
+
+		xml_node_struct* next = node->next_sibling;
+
+		if (next)
+			next->prev_sibling_c = child;
+		else
+			parent->first_child->prev_sibling_c = child;
+
+		child->next_sibling = next;
+		child->prev_sibling_c = node;
+
+		node->next_sibling = child;
+	}
+
+	inline void insert_node_before(xml_node_struct* child, xml_node_struct* node)
+	{
+		xml_node_struct* parent = node->parent;
+
+		child->parent = parent;
+
+		xml_node_struct* prev = node->prev_sibling_c;
+
+		if (prev->next_sibling)
+			prev->next_sibling = child;
+		else
+			parent->first_child = child;
+
+		child->prev_sibling_c = prev;
+		child->next_sibling = node;
+
+		node->prev_sibling_c = child;
+	}
+
+	inline void remove_node(xml_node_struct* node)
+	{
+		xml_node_struct* parent = node->parent;
+
+		xml_node_struct* next = node->next_sibling;
+		xml_node_struct* prev = node->prev_sibling_c;
+
+		if (next)
+			next->prev_sibling_c = prev;
+		else
+			parent->first_child->prev_sibling_c = prev;
+
+		if (prev->next_sibling)
+			prev->next_sibling = next;
+		else
+			parent->first_child = next;
+
+		node->parent = 0;
+		node->prev_sibling_c = 0;
+		node->next_sibling = 0;
+	}
+
+	inline void append_attribute(xml_attribute_struct* attr, xml_node_struct* node)
+	{
+		xml_attribute_struct* head = node->first_attribute;
+
+		if (head)
+		{
+			xml_attribute_struct* tail = head->prev_attribute_c;
+
+			tail->next_attribute = attr;
+			attr->prev_attribute_c = tail;
+			head->prev_attribute_c = attr;
+		}
+		else
+		{
+			node->first_attribute = attr;
+			attr->prev_attribute_c = attr;
+		}
+	}
+
+	inline void prepend_attribute(xml_attribute_struct* attr, xml_node_struct* node)
+	{
+		xml_attribute_struct* head = node->first_attribute;
+
+		if (head)
+		{
+			attr->prev_attribute_c = head->prev_attribute_c;
+			head->prev_attribute_c = attr;
+		}
+		else
+			attr->prev_attribute_c = attr;
+
+		attr->next_attribute = head;
+		node->first_attribute = attr;
+	}
+
+	inline void insert_attribute_after(xml_attribute_struct* attr, xml_attribute_struct* place, xml_node_struct* node)
+	{
+		xml_attribute_struct* next = place->next_attribute;
+
+		if (next)
+			next->prev_attribute_c = attr;
+		else
+			node->first_attribute->prev_attribute_c = attr;
+
+		attr->next_attribute = next;
+		attr->prev_attribute_c = place;
+		place->next_attribute = attr;
+	}
+
+	inline void insert_attribute_before(xml_attribute_struct* attr, xml_attribute_struct* place, xml_node_struct* node)
+	{
+		xml_attribute_struct* prev = place->prev_attribute_c;
+
+		if (prev->next_attribute)
+			prev->next_attribute = attr;
+		else
+			node->first_attribute = attr;
+
+		attr->prev_attribute_c = prev;
+		attr->next_attribute = place;
+		place->prev_attribute_c = attr;
+	}
+
+	inline void remove_attribute(xml_attribute_struct* attr, xml_node_struct* node)
+	{
+		xml_attribute_struct* next = attr->next_attribute;
+		xml_attribute_struct* prev = attr->prev_attribute_c;
+
+		if (next)
+			next->prev_attribute_c = prev;
+		else
+			node->first_attribute->prev_attribute_c = prev;
+
+		if (prev->next_attribute)
+			prev->next_attribute = next;
+		else
+			node->first_attribute = next;
+
+		attr->prev_attribute_c = 0;
+		attr->next_attribute = 0;
+	}
+
+	PUGI_IMPL_FN_NO_INLINE xml_node_struct* append_new_node(xml_node_struct* node, xml_allocator& alloc, xml_node_type type = node_element)
+	{
+		if (!alloc.reserve()) return 0;
+
+		xml_node_struct* child = allocate_node(alloc, type);
+		if (!child) return 0;
+
+		append_node(child, node);
+
+		return child;
+	}
+
+	PUGI_IMPL_FN_NO_INLINE xml_attribute_struct* append_new_attribute(xml_node_struct* node, xml_allocator& alloc)
+	{
+		if (!alloc.reserve()) return 0;
+
+		xml_attribute_struct* attr = allocate_attribute(alloc);
+		if (!attr) return 0;
+
+		append_attribute(attr, node);
+
+		return attr;
+	}
+PUGI_IMPL_NS_END
+
+// Helper classes for code generation
+PUGI_IMPL_NS_BEGIN
+	struct opt_false
+	{
+		enum { value = 0 };
+	};
+
+	struct opt_true
+	{
+		enum { value = 1 };
+	};
+PUGI_IMPL_NS_END
+
+// Unicode utilities
+PUGI_IMPL_NS_BEGIN
+	inline uint16_t endian_swap(uint16_t value)
+	{
+		return static_cast<uint16_t>(((value & 0xff) << 8) | (value >> 8));
+	}
+
+	inline uint32_t endian_swap(uint32_t value)
+	{
+		return ((value & 0xff) << 24) | ((value & 0xff00) << 8) | ((value & 0xff0000) >> 8) | (value >> 24);
+	}
+
+	struct utf8_counter
+	{
+		typedef size_t value_type;
+
+		static value_type low(value_type result, uint32_t ch)
+		{
+			// U+0000..U+007F
+			if (ch < 0x80) return result + 1;
+			// U+0080..U+07FF
+			else if (ch < 0x800) return result + 2;
+			// U+0800..U+FFFF
+			else return result + 3;
+		}
+
+		static value_type high(value_type result, uint32_t)
+		{
+			// U+10000..U+10FFFF
+			return result + 4;
+		}
+	};
+
+	struct utf8_writer
+	{
+		typedef uint8_t* value_type;
+
+		static value_type low(value_type result, uint32_t ch)
+		{
+			// U+0000..U+007F
+			if (ch < 0x80)
+			{
+				*result = static_cast<uint8_t>(ch);
+				return result + 1;
+			}
+			// U+0080..U+07FF
+			else if (ch < 0x800)
+			{
+				result[0] = static_cast<uint8_t>(0xC0 | (ch >> 6));
+				result[1] = static_cast<uint8_t>(0x80 | (ch & 0x3F));
+				return result + 2;
+			}
+			// U+0800..U+FFFF
+			else
+			{
+				result[0] = static_cast<uint8_t>(0xE0 | (ch >> 12));
+				result[1] = static_cast<uint8_t>(0x80 | ((ch >> 6) & 0x3F));
+				result[2] = static_cast<uint8_t>(0x80 | (ch & 0x3F));
+				return result + 3;
+			}
+		}
+
+		static value_type high(value_type result, uint32_t ch)
+		{
+			// U+10000..U+10FFFF
+			result[0] = static_cast<uint8_t>(0xF0 | (ch >> 18));
+			result[1] = static_cast<uint8_t>(0x80 | ((ch >> 12) & 0x3F));
+			result[2] = static_cast<uint8_t>(0x80 | ((ch >> 6) & 0x3F));
+			result[3] = static_cast<uint8_t>(0x80 | (ch & 0x3F));
+			return result + 4;
+		}
+
+		static value_type any(value_type result, uint32_t ch)
+		{
+			return (ch < 0x10000) ? low(result, ch) : high(result, ch);
+		}
+	};
+
+	struct utf16_counter
+	{
+		typedef size_t value_type;
+
+		static value_type low(value_type result, uint32_t)
+		{
+			return result + 1;
+		}
+
+		static value_type high(value_type result, uint32_t)
+		{
+			return result + 2;
+		}
+	};
+
+	struct utf16_writer
+	{
+		typedef uint16_t* value_type;
+
+		static value_type low(value_type result, uint32_t ch)
+		{
+			*result = static_cast<uint16_t>(ch);
+
+			return result + 1;
+		}
+
+		static value_type high(value_type result, uint32_t ch)
+		{
+			uint32_t msh = static_cast<uint32_t>(ch - 0x10000) >> 10;
+			uint32_t lsh = static_cast<uint32_t>(ch - 0x10000) & 0x3ff;
+
+			result[0] = static_cast<uint16_t>(0xD800 + msh);
+			result[1] = static_cast<uint16_t>(0xDC00 + lsh);
+
+			return result + 2;
+		}
+
+		static value_type any(value_type result, uint32_t ch)
+		{
+			return (ch < 0x10000) ? low(result, ch) : high(result, ch);
+		}
+	};
+
+	struct utf32_counter
+	{
+		typedef size_t value_type;
+
+		static value_type low(value_type result, uint32_t)
+		{
+			return result + 1;
+		}
+
+		static value_type high(value_type result, uint32_t)
+		{
+			return result + 1;
+		}
+	};
+
+	struct utf32_writer
+	{
+		typedef uint32_t* value_type;
+
+		static value_type low(value_type result, uint32_t ch)
+		{
+			*result = ch;
+
+			return result + 1;
+		}
+
+		static value_type high(value_type result, uint32_t ch)
+		{
+			*result = ch;
+
+			return result + 1;
+		}
+
+		static value_type any(value_type result, uint32_t ch)
+		{
+			*result = ch;
+
+			return result + 1;
+		}
+	};
+
+	struct latin1_writer
+	{
+		typedef uint8_t* value_type;
+
+		static value_type low(value_type result, uint32_t ch)
+		{
+			*result = static_cast<uint8_t>(ch > 255 ? '?' : ch);
+
+			return result + 1;
+		}
+
+		static value_type high(value_type result, uint32_t ch)
+		{
+			(void)ch;
+
+			*result = '?';
+
+			return result + 1;
+		}
+	};
+
+	struct utf8_decoder
+	{
+		typedef uint8_t type;
+
+		template <typename Traits> static inline typename Traits::value_type process(const uint8_t* data, size_t size, typename Traits::value_type result, Traits)
+		{
+			const uint8_t utf8_byte_mask = 0x3f;
+
+			while (size)
+			{
+				uint8_t lead = *data;
+
+				// 0xxxxxxx -> U+0000..U+007F
+				if (lead < 0x80)
+				{
+					result = Traits::low(result, lead);
+					data += 1;
+					size -= 1;
+
+					// process aligned single-byte (ascii) blocks
+					if ((reinterpret_cast<uintptr_t>(data) & 3) == 0)
+					{
+						// round-trip through void* to silence 'cast increases required alignment of target type' warnings
+						while (size >= 4 && (*static_cast<const uint32_t*>(static_cast<const void*>(data)) & 0x80808080) == 0)
+						{
+							result = Traits::low(result, data[0]);
+							result = Traits::low(result, data[1]);
+							result = Traits::low(result, data[2]);
+							result = Traits::low(result, data[3]);
+							data += 4;
+							size -= 4;
+						}
+					}
+				}
+				// 110xxxxx -> U+0080..U+07FF
+				else if (static_cast<unsigned int>(lead - 0xC0) < 0x20 && size >= 2 && (data[1] & 0xc0) == 0x80)
+				{
+					result = Traits::low(result, ((lead & ~0xC0) << 6) | (data[1] & utf8_byte_mask));
+					data += 2;
+					size -= 2;
+				}
+				// 1110xxxx -> U+0800-U+FFFF
+				else if (static_cast<unsigned int>(lead - 0xE0) < 0x10 && size >= 3 && (data[1] & 0xc0) == 0x80 && (data[2] & 0xc0) == 0x80)
+				{
+					result = Traits::low(result, ((lead & ~0xE0) << 12) | ((data[1] & utf8_byte_mask) << 6) | (data[2] & utf8_byte_mask));
+					data += 3;
+					size -= 3;
+				}
+				// 11110xxx -> U+10000..U+10FFFF
+				else if (static_cast<unsigned int>(lead - 0xF0) < 0x08 && size >= 4 && (data[1] & 0xc0) == 0x80 && (data[2] & 0xc0) == 0x80 && (data[3] & 0xc0) == 0x80)
+				{
+					result = Traits::high(result, ((lead & ~0xF0) << 18) | ((data[1] & utf8_byte_mask) << 12) | ((data[2] & utf8_byte_mask) << 6) | (data[3] & utf8_byte_mask));
+					data += 4;
+					size -= 4;
+				}
+				// 10xxxxxx or 11111xxx -> invalid
+				else
+				{
+					data += 1;
+					size -= 1;
+				}
+			}
+
+			return result;
+		}
+	};
+
+	template <typename opt_swap> struct utf16_decoder
+	{
+		typedef uint16_t type;
+
+		template <typename Traits> static inline typename Traits::value_type process(const uint16_t* data, size_t size, typename Traits::value_type result, Traits)
+		{
+			while (size)
+			{
+				uint16_t lead = opt_swap::value ? endian_swap(*data) : *data;
+
+				// U+0000..U+D7FF
+				if (lead < 0xD800)
+				{
+					result = Traits::low(result, lead);
+					data += 1;
+					size -= 1;
+				}
+				// U+E000..U+FFFF
+				else if (static_cast<unsigned int>(lead - 0xE000) < 0x2000)
+				{
+					result = Traits::low(result, lead);
+					data += 1;
+					size -= 1;
+				}
+				// surrogate pair lead
+				else if (static_cast<unsigned int>(lead - 0xD800) < 0x400 && size >= 2)
+				{
+					uint16_t next = opt_swap::value ? endian_swap(data[1]) : data[1];
+
+					if (static_cast<unsigned int>(next - 0xDC00) < 0x400)
+					{
+						result = Traits::high(result, 0x10000 + ((lead & 0x3ff) << 10) + (next & 0x3ff));
+						data += 2;
+						size -= 2;
+					}
+					else
+					{
+						data += 1;
+						size -= 1;
+					}
+				}
+				else
+				{
+					data += 1;
+					size -= 1;
+				}
+			}
+
+			return result;
+		}
+	};
+
+	template <typename opt_swap> struct utf32_decoder
+	{
+		typedef uint32_t type;
+
+		template <typename Traits> static inline typename Traits::value_type process(const uint32_t* data, size_t size, typename Traits::value_type result, Traits)
+		{
+			while (size)
+			{
+				uint32_t lead = opt_swap::value ? endian_swap(*data) : *data;
+
+				// U+0000..U+FFFF
+				if (lead < 0x10000)
+				{
+					result = Traits::low(result, lead);
+					data += 1;
+					size -= 1;
+				}
+				// U+10000..U+10FFFF
+				else
+				{
+					result = Traits::high(result, lead);
+					data += 1;
+					size -= 1;
+				}
+			}
+
+			return result;
+		}
+	};
+
+	struct latin1_decoder
+	{
+		typedef uint8_t type;
+
+		template <typename Traits> static inline typename Traits::value_type process(const uint8_t* data, size_t size, typename Traits::value_type result, Traits)
+		{
+			while (size)
+			{
+				result = Traits::low(result, *data);
+				data += 1;
+				size -= 1;
+			}
+
+			return result;
+		}
+	};
+
+	template <size_t size> struct wchar_selector;
+
+	template <> struct wchar_selector<2>
+	{
+		typedef uint16_t type;
+		typedef utf16_counter counter;
+		typedef utf16_writer writer;
+		typedef utf16_decoder<opt_false> decoder;
+	};
+
+	template <> struct wchar_selector<4>
+	{
+		typedef uint32_t type;
+		typedef utf32_counter counter;
+		typedef utf32_writer writer;
+		typedef utf32_decoder<opt_false> decoder;
+	};
+
+	typedef wchar_selector<sizeof(wchar_t)>::counter wchar_counter;
+	typedef wchar_selector<sizeof(wchar_t)>::writer wchar_writer;
+
+	struct wchar_decoder
+	{
+		typedef wchar_t type;
+
+		template <typename Traits> static inline typename Traits::value_type process(const wchar_t* data, size_t size, typename Traits::value_type result, Traits traits)
+		{
+			typedef wchar_selector<sizeof(wchar_t)>::decoder decoder;
+
+			return decoder::process(reinterpret_cast<const typename decoder::type*>(data), size, result, traits);
+		}
+	};
+
+#ifdef PUGIXML_WCHAR_MODE
+	PUGI_IMPL_FN void convert_wchar_endian_swap(wchar_t* result, const wchar_t* data, size_t length)
+	{
+		for (size_t i = 0; i < length; ++i)
+			result[i] = static_cast<wchar_t>(endian_swap(static_cast<wchar_selector<sizeof(wchar_t)>::type>(data[i])));
+	}
+#endif
+PUGI_IMPL_NS_END
+
+PUGI_IMPL_NS_BEGIN
+	enum chartype_t
+	{
+		ct_parse_pcdata = 1,	// \0, &, \r, <
+		ct_parse_attr = 2,		// \0, &, \r, ', "
+		ct_parse_attr_ws = 4,	// \0, &, \r, ', ", \n, tab
+		ct_space = 8,			// \r, \n, space, tab
+		ct_parse_cdata = 16,	// \0, ], >, \r
+		ct_parse_comment = 32,	// \0, -, >, \r
+		ct_symbol = 64,			// Any symbol > 127, a-z, A-Z, 0-9, _, :, -, .
+		ct_start_symbol = 128	// Any symbol > 127, a-z, A-Z, _, :
+	};
+
+	static const unsigned char chartype_table[256] =
+	{
+		55,  0,   0,   0,   0,   0,   0,   0,      0,   12,  12,  0,   0,   63,  0,   0,   // 0-15
+		0,   0,   0,   0,   0,   0,   0,   0,      0,   0,   0,   0,   0,   0,   0,   0,   // 16-31
+		8,   0,   6,   0,   0,   0,   7,   6,      0,   0,   0,   0,   0,   96,  64,  0,   // 32-47
+		64,  64,  64,  64,  64,  64,  64,  64,     64,  64,  192, 0,   1,   0,   48,  0,   // 48-63
+		0,   192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192, // 64-79
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 0,   0,   16,  0,   192, // 80-95
+		0,   192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192, // 96-111
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 0, 0, 0, 0, 0,           // 112-127
+
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192, // 128+
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192
+	};
+
+	enum chartypex_t
+	{
+		ctx_special_pcdata = 1,   // Any symbol >= 0 and < 32 (except \t, \r, \n), &, <, >
+		ctx_special_attr = 2,     // Any symbol >= 0 and < 32, &, <, ", '
+		ctx_start_symbol = 4,	  // Any symbol > 127, a-z, A-Z, _
+		ctx_digit = 8,			  // 0-9
+		ctx_symbol = 16			  // Any symbol > 127, a-z, A-Z, 0-9, _, -, .
+	};
+
+	static const unsigned char chartypex_table[256] =
+	{
+		3,  3,  3,  3,  3,  3,  3,  3,     3,  2,  2,  3,  3,  2,  3,  3,     // 0-15
+		3,  3,  3,  3,  3,  3,  3,  3,     3,  3,  3,  3,  3,  3,  3,  3,     // 16-31
+		0,  0,  2,  0,  0,  0,  3,  2,     0,  0,  0,  0,  0, 16, 16,  0,     // 32-47
+		24, 24, 24, 24, 24, 24, 24, 24,    24, 24, 0,  0,  3,  0,  1,  0,     // 48-63
+
+		0,  20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,    // 64-79
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 0,  0,  0,  0,  20,    // 80-95
+		0,  20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,    // 96-111
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 0,  0,  0,  0,  0,     // 112-127
+
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,    // 128+
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20
+	};
+
+#ifdef PUGIXML_WCHAR_MODE
+	#define PUGI_IMPL_IS_CHARTYPE_IMPL(c, ct, table) ((static_cast<unsigned int>(c) < 128 ? table[static_cast<unsigned int>(c)] : table[128]) & (ct))
+#else
+	#define PUGI_IMPL_IS_CHARTYPE_IMPL(c, ct, table) (table[static_cast<unsigned char>(c)] & (ct))
+#endif
+
+	#define PUGI_IMPL_IS_CHARTYPE(c, ct) PUGI_IMPL_IS_CHARTYPE_IMPL(c, ct, chartype_table)
+	#define PUGI_IMPL_IS_CHARTYPEX(c, ct) PUGI_IMPL_IS_CHARTYPE_IMPL(c, ct, chartypex_table)
+
+	PUGI_IMPL_FN bool is_little_endian()
+	{
+		unsigned int ui = 1;
+
+		return *reinterpret_cast<unsigned char*>(&ui) == 1;
+	}
+
+	PUGI_IMPL_FN xml_encoding get_wchar_encoding()
+	{
+		PUGI_IMPL_STATIC_ASSERT(sizeof(wchar_t) == 2 || sizeof(wchar_t) == 4);
+
+		if (sizeof(wchar_t) == 2)
+			return is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+		else
+			return is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+	}
+
+	PUGI_IMPL_FN bool parse_declaration_encoding(const uint8_t* data, size_t size, const uint8_t*& out_encoding, size_t& out_length)
+	{
+	#define PUGI_IMPL_SCANCHAR(ch) { if (offset >= size || data[offset] != ch) return false; offset++; }
+	#define PUGI_IMPL_SCANCHARTYPE(ct) { while (offset < size && PUGI_IMPL_IS_CHARTYPE(data[offset], ct)) offset++; }
+
+		// check if we have a non-empty XML declaration
+		if (size < 6 || !((data[0] == '<') & (data[1] == '?') & (data[2] == 'x') & (data[3] == 'm') & (data[4] == 'l') && PUGI_IMPL_IS_CHARTYPE(data[5], ct_space)))
+			return false;
+
+		// scan XML declaration until the encoding field
+		for (size_t i = 6; i + 1 < size; ++i)
+		{
+			// declaration can not contain ? in quoted values
+			if (data[i] == '?')
+				return false;
+
+			if (data[i] == 'e' && data[i + 1] == 'n')
+			{
+				size_t offset = i;
+
+				// encoding follows the version field which can't contain 'en' so this has to be the encoding if XML is well formed
+				PUGI_IMPL_SCANCHAR('e'); PUGI_IMPL_SCANCHAR('n'); PUGI_IMPL_SCANCHAR('c'); PUGI_IMPL_SCANCHAR('o');
+				PUGI_IMPL_SCANCHAR('d'); PUGI_IMPL_SCANCHAR('i'); PUGI_IMPL_SCANCHAR('n'); PUGI_IMPL_SCANCHAR('g');
+
+				// S? = S?
+				PUGI_IMPL_SCANCHARTYPE(ct_space);
+				PUGI_IMPL_SCANCHAR('=');
+				PUGI_IMPL_SCANCHARTYPE(ct_space);
+
+				// the only two valid delimiters are ' and "
+				uint8_t delimiter = (offset < size && data[offset] == '"') ? '"' : '\'';
+
+				PUGI_IMPL_SCANCHAR(delimiter);
+
+				size_t start = offset;
+
+				out_encoding = data + offset;
+
+				PUGI_IMPL_SCANCHARTYPE(ct_symbol);
+
+				out_length = offset - start;
+
+				PUGI_IMPL_SCANCHAR(delimiter);
+
+				return true;
+			}
+		}
+
+		return false;
+
+	#undef PUGI_IMPL_SCANCHAR
+	#undef PUGI_IMPL_SCANCHARTYPE
+	}
+
+	PUGI_IMPL_FN xml_encoding guess_buffer_encoding(const uint8_t* data, size_t size)
+	{
+		// skip encoding autodetection if input buffer is too small
+		if (size < 4) return encoding_utf8;
+
+		uint8_t d0 = data[0], d1 = data[1], d2 = data[2], d3 = data[3];
+
+		// look for BOM in first few bytes
+		if (d0 == 0 && d1 == 0 && d2 == 0xfe && d3 == 0xff) return encoding_utf32_be;
+		if (d0 == 0xff && d1 == 0xfe && d2 == 0 && d3 == 0) return encoding_utf32_le;
+		if (d0 == 0xfe && d1 == 0xff) return encoding_utf16_be;
+		if (d0 == 0xff && d1 == 0xfe) return encoding_utf16_le;
+		if (d0 == 0xef && d1 == 0xbb && d2 == 0xbf) return encoding_utf8;
+
+		// look for <, <? or <?xm in various encodings
+		if (d0 == 0 && d1 == 0 && d2 == 0 && d3 == 0x3c) return encoding_utf32_be;
+		if (d0 == 0x3c && d1 == 0 && d2 == 0 && d3 == 0) return encoding_utf32_le;
+		if (d0 == 0 && d1 == 0x3c && d2 == 0 && d3 == 0x3f) return encoding_utf16_be;
+		if (d0 == 0x3c && d1 == 0 && d2 == 0x3f && d3 == 0) return encoding_utf16_le;
+
+		// look for utf16 < followed by node name (this may fail, but is better than utf8 since it's zero terminated so early)
+		if (d0 == 0 && d1 == 0x3c) return encoding_utf16_be;
+		if (d0 == 0x3c && d1 == 0) return encoding_utf16_le;
+
+		// no known BOM detected; parse declaration
+		const uint8_t* enc = 0;
+		size_t enc_length = 0;
+
+		if (d0 == 0x3c && d1 == 0x3f && d2 == 0x78 && d3 == 0x6d && parse_declaration_encoding(data, size, enc, enc_length))
+		{
+			// iso-8859-1 (case-insensitive)
+			if (enc_length == 10
+				&& (enc[0] | ' ') == 'i' && (enc[1] | ' ') == 's' && (enc[2] | ' ') == 'o'
+				&& enc[3] == '-' && enc[4] == '8' && enc[5] == '8' && enc[6] == '5' && enc[7] == '9'
+				&& enc[8] == '-' && enc[9] == '1')
+				return encoding_latin1;
+
+			// latin1 (case-insensitive)
+			if (enc_length == 6
+				&& (enc[0] | ' ') == 'l' && (enc[1] | ' ') == 'a' && (enc[2] | ' ') == 't'
+				&& (enc[3] | ' ') == 'i' && (enc[4] | ' ') == 'n'
+				&& enc[5] == '1')
+				return encoding_latin1;
+		}
+
+		return encoding_utf8;
+	}
+
+	PUGI_IMPL_FN xml_encoding get_buffer_encoding(xml_encoding encoding, const void* contents, size_t size)
+	{
+		// replace wchar encoding with utf implementation
+		if (encoding == encoding_wchar) return get_wchar_encoding();
+
+		// replace utf16 encoding with utf16 with specific endianness
+		if (encoding == encoding_utf16) return is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+		// replace utf32 encoding with utf32 with specific endianness
+		if (encoding == encoding_utf32) return is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+		// only do autodetection if no explicit encoding is requested
+		if (encoding != encoding_auto) return encoding;
+
+		// try to guess encoding (based on XML specification, Appendix F.1)
+		const uint8_t* data = static_cast<const uint8_t*>(contents);
+
+		return guess_buffer_encoding(data, size);
+	}
+
+	PUGI_IMPL_FN bool get_mutable_buffer(char_t*& out_buffer, size_t& out_length, const void* contents, size_t size, bool is_mutable)
+	{
+		size_t length = size / sizeof(char_t);
+
+		if (is_mutable)
+		{
+			out_buffer = static_cast<char_t*>(const_cast<void*>(contents));
+			out_length = length;
+		}
+		else
+		{
+			char_t* buffer = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+			if (!buffer) return false;
+
+			if (contents)
+				memcpy(buffer, contents, length * sizeof(char_t));
+			else
+				assert(length == 0);
+
+			buffer[length] = 0;
+
+			out_buffer = buffer;
+			out_length = length + 1;
+		}
+
+		return true;
+	}
+
+#ifdef PUGIXML_WCHAR_MODE
+	PUGI_IMPL_FN bool need_endian_swap_utf(xml_encoding le, xml_encoding re)
+	{
+		return (le == encoding_utf16_be && re == encoding_utf16_le) || (le == encoding_utf16_le && re == encoding_utf16_be) ||
+			   (le == encoding_utf32_be && re == encoding_utf32_le) || (le == encoding_utf32_le && re == encoding_utf32_be);
+	}
+
+	PUGI_IMPL_FN bool convert_buffer_endian_swap(char_t*& out_buffer, size_t& out_length, const void* contents, size_t size, bool is_mutable)
+	{
+		const char_t* data = static_cast<const char_t*>(contents);
+		size_t length = size / sizeof(char_t);
+
+		if (is_mutable)
+		{
+			char_t* buffer = const_cast<char_t*>(data);
+
+			convert_wchar_endian_swap(buffer, data, length);
+
+			out_buffer = buffer;
+			out_length = length;
+		}
+		else
+		{
+			char_t* buffer = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+			if (!buffer) return false;
+
+			convert_wchar_endian_swap(buffer, data, length);
+			buffer[length] = 0;
+
+			out_buffer = buffer;
+			out_length = length + 1;
+		}
+
+		return true;
+	}
+
+	template <typename D> PUGI_IMPL_FN bool convert_buffer_generic(char_t*& out_buffer, size_t& out_length, const void* contents, size_t size, D)
+	{
+		const typename D::type* data = static_cast<const typename D::type*>(contents);
+		size_t data_length = size / sizeof(typename D::type);
+
+		// first pass: get length in wchar_t units
+		size_t length = D::process(data, data_length, 0, wchar_counter());
+
+		// allocate buffer of suitable length
+		char_t* buffer = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+		if (!buffer) return false;
+
+		// second pass: convert utf16 input to wchar_t
+		wchar_writer::value_type obegin = reinterpret_cast<wchar_writer::value_type>(buffer);
+		wchar_writer::value_type oend = D::process(data, data_length, obegin, wchar_writer());
+
+		assert(oend == obegin + length);
+		*oend = 0;
+
+		out_buffer = buffer;
+		out_length = length + 1;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool convert_buffer(char_t*& out_buffer, size_t& out_length, xml_encoding encoding, const void* contents, size_t size, bool is_mutable)
+	{
+		// get native encoding
+		xml_encoding wchar_encoding = get_wchar_encoding();
+
+		// fast path: no conversion required
+		if (encoding == wchar_encoding)
+			return get_mutable_buffer(out_buffer, out_length, contents, size, is_mutable);
+
+		// only endian-swapping is required
+		if (need_endian_swap_utf(encoding, wchar_encoding))
+			return convert_buffer_endian_swap(out_buffer, out_length, contents, size, is_mutable);
+
+		// source encoding is utf8
+		if (encoding == encoding_utf8)
+			return convert_buffer_generic(out_buffer, out_length, contents, size, utf8_decoder());
+
+		// source encoding is utf16
+		if (encoding == encoding_utf16_be || encoding == encoding_utf16_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+			return (native_encoding == encoding) ?
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf16_decoder<opt_false>()) :
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf16_decoder<opt_true>());
+		}
+
+		// source encoding is utf32
+		if (encoding == encoding_utf32_be || encoding == encoding_utf32_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+			return (native_encoding == encoding) ?
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf32_decoder<opt_false>()) :
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf32_decoder<opt_true>());
+		}
+
+		// source encoding is latin1
+		if (encoding == encoding_latin1)
+			return convert_buffer_generic(out_buffer, out_length, contents, size, latin1_decoder());
+
+		assert(false && "Invalid encoding"); // unreachable
+		return false;
+	}
+#else
+	template <typename D> PUGI_IMPL_FN bool convert_buffer_generic(char_t*& out_buffer, size_t& out_length, const void* contents, size_t size, D)
+	{
+		const typename D::type* data = static_cast<const typename D::type*>(contents);
+		size_t data_length = size / sizeof(typename D::type);
+
+		// first pass: get length in utf8 units
+		size_t length = D::process(data, data_length, 0, utf8_counter());
+
+		// allocate buffer of suitable length
+		char_t* buffer = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+		if (!buffer) return false;
+
+		// second pass: convert utf16 input to utf8
+		uint8_t* obegin = reinterpret_cast<uint8_t*>(buffer);
+		uint8_t* oend = D::process(data, data_length, obegin, utf8_writer());
+
+		assert(oend == obegin + length);
+		*oend = 0;
+
+		out_buffer = buffer;
+		out_length = length + 1;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN size_t get_latin1_7bit_prefix_length(const uint8_t* data, size_t size)
+	{
+		for (size_t i = 0; i < size; ++i)
+			if (data[i] > 127)
+				return i;
+
+		return size;
+	}
+
+	PUGI_IMPL_FN bool convert_buffer_latin1(char_t*& out_buffer, size_t& out_length, const void* contents, size_t size, bool is_mutable)
+	{
+		const uint8_t* data = static_cast<const uint8_t*>(contents);
+		size_t data_length = size;
+
+		// get size of prefix that does not need utf8 conversion
+		size_t prefix_length = get_latin1_7bit_prefix_length(data, data_length);
+		assert(prefix_length <= data_length);
+
+		const uint8_t* postfix = data + prefix_length;
+		size_t postfix_length = data_length - prefix_length;
+
+		// if no conversion is needed, just return the original buffer
+		if (postfix_length == 0) return get_mutable_buffer(out_buffer, out_length, contents, size, is_mutable);
+
+		// first pass: get length in utf8 units
+		size_t length = prefix_length + latin1_decoder::process(postfix, postfix_length, 0, utf8_counter());
+
+		// allocate buffer of suitable length
+		char_t* buffer = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+		if (!buffer) return false;
+
+		// second pass: convert latin1 input to utf8
+		memcpy(buffer, data, prefix_length);
+
+		uint8_t* obegin = reinterpret_cast<uint8_t*>(buffer);
+		uint8_t* oend = latin1_decoder::process(postfix, postfix_length, obegin + prefix_length, utf8_writer());
+
+		assert(oend == obegin + length);
+		*oend = 0;
+
+		out_buffer = buffer;
+		out_length = length + 1;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool convert_buffer(char_t*& out_buffer, size_t& out_length, xml_encoding encoding, const void* contents, size_t size, bool is_mutable)
+	{
+		// fast path: no conversion required
+		if (encoding == encoding_utf8)
+			return get_mutable_buffer(out_buffer, out_length, contents, size, is_mutable);
+
+		// source encoding is utf16
+		if (encoding == encoding_utf16_be || encoding == encoding_utf16_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+			return (native_encoding == encoding) ?
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf16_decoder<opt_false>()) :
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf16_decoder<opt_true>());
+		}
+
+		// source encoding is utf32
+		if (encoding == encoding_utf32_be || encoding == encoding_utf32_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+			return (native_encoding == encoding) ?
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf32_decoder<opt_false>()) :
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf32_decoder<opt_true>());
+		}
+
+		// source encoding is latin1
+		if (encoding == encoding_latin1)
+			return convert_buffer_latin1(out_buffer, out_length, contents, size, is_mutable);
+
+		assert(false && "Invalid encoding"); // unreachable
+		return false;
+	}
+#endif
+
+	PUGI_IMPL_FN size_t as_utf8_begin(const wchar_t* str, size_t length)
+	{
+		// get length in utf8 characters
+		return wchar_decoder::process(str, length, 0, utf8_counter());
+	}
+
+	PUGI_IMPL_FN void as_utf8_end(char* buffer, size_t size, const wchar_t* str, size_t length)
+	{
+		// convert to utf8
+		uint8_t* begin = reinterpret_cast<uint8_t*>(buffer);
+		uint8_t* end = wchar_decoder::process(str, length, begin, utf8_writer());
+
+		assert(begin + size == end);
+		(void)!end;
+		(void)!size;
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN std::string as_utf8_impl(const wchar_t* str, size_t length)
+	{
+		// first pass: get length in utf8 characters
+		size_t size = as_utf8_begin(str, length);
+
+		// allocate resulting string
+		std::string result;
+		result.resize(size);
+
+		// second pass: convert to utf8
+		if (size > 0) as_utf8_end(&result[0], size, str, length);
+
+		return result;
+	}
+
+	PUGI_IMPL_FN std::basic_string<wchar_t> as_wide_impl(const char* str, size_t size)
+	{
+		const uint8_t* data = reinterpret_cast<const uint8_t*>(str);
+
+		// first pass: get length in wchar_t units
+		size_t length = utf8_decoder::process(data, size, 0, wchar_counter());
+
+		// allocate resulting string
+		std::basic_string<wchar_t> result;
+		result.resize(length);
+
+		// second pass: convert to wchar_t
+		if (length > 0)
+		{
+			wchar_writer::value_type begin = reinterpret_cast<wchar_writer::value_type>(&result[0]);
+			wchar_writer::value_type end = utf8_decoder::process(data, size, begin, wchar_writer());
+
+			assert(begin + length == end);
+			(void)!end;
+		}
+
+		return result;
+	}
+#endif
+
+	template <typename Header>
+	inline bool strcpy_insitu_allow(size_t length, const Header& header, uintptr_t header_mask, char_t* target)
+	{
+		// never reuse shared memory
+		if (header & xml_memory_page_contents_shared_mask) return false;
+
+		size_t target_length = strlength(target);
+
+		// always reuse document buffer memory if possible
+		if ((header & header_mask) == 0) return target_length >= length;
+
+		// reuse heap memory if waste is not too great
+		const size_t reuse_threshold = 32;
+
+		return target_length >= length && (target_length < reuse_threshold || target_length - length < target_length / 2);
+	}
+
+	template <typename String, typename Header>
+	PUGI_IMPL_FN bool strcpy_insitu(String& dest, Header& header, uintptr_t header_mask, const char_t* source, size_t source_length)
+	{
+		assert((header & header_mask) == 0 || dest); // header bit indicates whether dest was previously allocated
+
+		if (source_length == 0)
+		{
+			// empty string and null pointer are equivalent, so just deallocate old memory
+			xml_allocator* alloc = PUGI_IMPL_GETPAGE_IMPL(header)->allocator;
+
+			if (header & header_mask) alloc->deallocate_string(dest);
+
+			// mark the string as not allocated
+			dest = 0;
+			header &= ~header_mask;
+
+			return true;
+		}
+		else if (dest && strcpy_insitu_allow(source_length, header, header_mask, dest))
+		{
+			// we can reuse old buffer, so just copy the new data (including zero terminator)
+			memcpy(dest, source, source_length * sizeof(char_t));
+			dest[source_length] = 0;
+
+			return true;
+		}
+		else
+		{
+			xml_allocator* alloc = PUGI_IMPL_GETPAGE_IMPL(header)->allocator;
+
+			if (!alloc->reserve()) return false;
+
+			// allocate new buffer
+			char_t* buf = alloc->allocate_string(source_length + 1);
+			if (!buf) return false;
+
+			// copy the string (including zero terminator)
+			memcpy(buf, source, source_length * sizeof(char_t));
+			buf[source_length] = 0;
+
+			// deallocate old buffer (*after* the above to protect against overlapping memory and/or allocation failures)
+			if (header & header_mask) alloc->deallocate_string(dest);
+
+			// the string is now allocated, so set the flag
+			dest = buf;
+			header |= header_mask;
+
+			return true;
+		}
+	}
+
+	struct gap
+	{
+		char_t* end;
+		size_t size;
+
+		gap(): end(0), size(0)
+		{
+		}
+
+		// Push new gap, move s count bytes further (skipping the gap).
+		// Collapse previous gap.
+		void push(char_t*& s, size_t count)
+		{
+			if (end) // there was a gap already; collapse it
+			{
+				// Move [old_gap_end, new_gap_start) to [old_gap_start, ...)
+				assert(s >= end);
+				memmove(end - size, end, reinterpret_cast<char*>(s) - reinterpret_cast<char*>(end));
+			}
+
+			s += count; // end of current gap
+
+			// "merge" two gaps
+			end = s;
+			size += count;
+		}
+
+		// Collapse all gaps, return past-the-end pointer
+		char_t* flush(char_t* s)
+		{
+			if (end)
+			{
+				// Move [old_gap_end, current_pos) to [old_gap_start, ...)
+				assert(s >= end);
+				memmove(end - size, end, reinterpret_cast<char*>(s) - reinterpret_cast<char*>(end));
+
+				return s - size;
+			}
+			else return s;
+		}
+	};
+
+	PUGI_IMPL_FN char_t* strconv_escape(char_t* s, gap& g)
+	{
+		char_t* stre = s + 1;
+
+		switch (*stre)
+		{
+			case '#':	// &#...
+			{
+				unsigned int ucsc = 0;
+
+				if (stre[1] == 'x') // &#x... (hex code)
+				{
+					stre += 2;
+
+					char_t ch = *stre;
+
+					if (ch == ';') return stre;
+
+					for (;;)
+					{
+						if (static_cast<unsigned int>(ch - '0') <= 9)
+							ucsc = 16 * ucsc + (ch - '0');
+						else if (static_cast<unsigned int>((ch | ' ') - 'a') <= 5)
+							ucsc = 16 * ucsc + ((ch | ' ') - 'a' + 10);
+						else if (ch == ';')
+							break;
+						else // cancel
+							return stre;
+
+						ch = *++stre;
+					}
+
+					++stre;
+				}
+				else	// &#... (dec code)
+				{
+					char_t ch = *++stre;
+
+					if (ch == ';') return stre;
+
+					for (;;)
+					{
+						if (static_cast<unsigned int>(ch - '0') <= 9)
+							ucsc = 10 * ucsc + (ch - '0');
+						else if (ch == ';')
+							break;
+						else // cancel
+							return stre;
+
+						ch = *++stre;
+					}
+
+					++stre;
+				}
+
+			#ifdef PUGIXML_WCHAR_MODE
+				s = reinterpret_cast<char_t*>(wchar_writer::any(reinterpret_cast<wchar_writer::value_type>(s), ucsc));
+			#else
+				s = reinterpret_cast<char_t*>(utf8_writer::any(reinterpret_cast<uint8_t*>(s), ucsc));
+			#endif
+
+				g.push(s, stre - s);
+				return stre;
+			}
+
+			case 'a':	// &a
+			{
+				++stre;
+
+				if (*stre == 'm') // &am
+				{
+					if (*++stre == 'p' && *++stre == ';') // &amp;
+					{
+						*s++ = '&';
+						++stre;
+
+						g.push(s, stre - s);
+						return stre;
+					}
+				}
+				else if (*stre == 'p') // &ap
+				{
+					if (*++stre == 'o' && *++stre == 's' && *++stre == ';') // &apos;
+					{
+						*s++ = '\'';
+						++stre;
+
+						g.push(s, stre - s);
+						return stre;
+					}
+				}
+				break;
+			}
+
+			case 'g': // &g
+			{
+				if (*++stre == 't' && *++stre == ';') // &gt;
+				{
+					*s++ = '>';
+					++stre;
+
+					g.push(s, stre - s);
+					return stre;
+				}
+				break;
+			}
+
+			case 'l': // &l
+			{
+				if (*++stre == 't' && *++stre == ';') // &lt;
+				{
+					*s++ = '<';
+					++stre;
+
+					g.push(s, stre - s);
+					return stre;
+				}
+				break;
+			}
+
+			case 'q': // &q
+			{
+				if (*++stre == 'u' && *++stre == 'o' && *++stre == 't' && *++stre == ';') // &quot;
+				{
+					*s++ = '"';
+					++stre;
+
+					g.push(s, stre - s);
+					return stre;
+				}
+				break;
+			}
+
+			default:
+				break;
+		}
+
+		return stre;
+	}
+
+	// Parser utilities
+	#define PUGI_IMPL_ENDSWITH(c, e)        ((c) == (e) || ((c) == 0 && endch == (e)))
+	#define PUGI_IMPL_SKIPWS()              { while (PUGI_IMPL_IS_CHARTYPE(*s, ct_space)) ++s; }
+	#define PUGI_IMPL_OPTSET(OPT)           ( optmsk & (OPT) )
+	#define PUGI_IMPL_PUSHNODE(TYPE)        { cursor = append_new_node(cursor, *alloc, TYPE); if (!cursor) PUGI_IMPL_THROW_ERROR(status_out_of_memory, s); }
+	#define PUGI_IMPL_POPNODE()             { cursor = cursor->parent; }
+	#define PUGI_IMPL_SCANFOR(X)            { while (*s != 0 && !(X)) ++s; }
+	#define PUGI_IMPL_SCANWHILE(X)          { while (X) ++s; }
+	#define PUGI_IMPL_SCANWHILE_UNROLL(X)   { for (;;) { char_t ss = s[0]; if (PUGI_IMPL_UNLIKELY(!(X))) { break; } ss = s[1]; if (PUGI_IMPL_UNLIKELY(!(X))) { s += 1; break; } ss = s[2]; if (PUGI_IMPL_UNLIKELY(!(X))) { s += 2; break; } ss = s[3]; if (PUGI_IMPL_UNLIKELY(!(X))) { s += 3; break; } s += 4; } }
+	#define PUGI_IMPL_ENDSEG()              { ch = *s; *s = 0; ++s; }
+	#define PUGI_IMPL_THROW_ERROR(err, m)   return error_offset = m, error_status = err, static_cast<char_t*>(0)
+	#define PUGI_IMPL_CHECK_ERROR(err, m)   { if (*s == 0) PUGI_IMPL_THROW_ERROR(err, m); }
+
+	PUGI_IMPL_FN char_t* strconv_comment(char_t* s, char_t endch)
+	{
+		gap g;
+
+		while (true)
+		{
+			PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_comment));
+
+			if (*s == '\r') // Either a single 0x0d or 0x0d 0x0a pair
+			{
+				*s++ = '\n'; // replace first one with 0x0a
+
+				if (*s == '\n') g.push(s, 1);
+			}
+			else if (s[0] == '-' && s[1] == '-' && PUGI_IMPL_ENDSWITH(s[2], '>')) // comment ends here
+			{
+				*g.flush(s) = 0;
+
+				return s + (s[2] == '>' ? 3 : 2);
+			}
+			else if (*s == 0)
+			{
+				return 0;
+			}
+			else ++s;
+		}
+	}
+
+	PUGI_IMPL_FN char_t* strconv_cdata(char_t* s, char_t endch)
+	{
+		gap g;
+
+		while (true)
+		{
+			PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_cdata));
+
+			if (*s == '\r') // Either a single 0x0d or 0x0d 0x0a pair
+			{
+				*s++ = '\n'; // replace first one with 0x0a
+
+				if (*s == '\n') g.push(s, 1);
+			}
+			else if (s[0] == ']' && s[1] == ']' && PUGI_IMPL_ENDSWITH(s[2], '>')) // CDATA ends here
+			{
+				*g.flush(s) = 0;
+
+				return s + 1;
+			}
+			else if (*s == 0)
+			{
+				return 0;
+			}
+			else ++s;
+		}
+	}
+
+	typedef char_t* (*strconv_pcdata_t)(char_t*);
+
+	template <typename opt_trim, typename opt_eol, typename opt_escape> struct strconv_pcdata_impl
+	{
+		static char_t* parse(char_t* s)
+		{
+			gap g;
+
+			char_t* begin = s;
+
+			while (true)
+			{
+				PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_pcdata));
+
+				if (*s == '<') // PCDATA ends here
+				{
+					char_t* end = g.flush(s);
+
+					if (opt_trim::value)
+						while (end > begin && PUGI_IMPL_IS_CHARTYPE(end[-1], ct_space))
+							--end;
+
+					*end = 0;
+
+					return s + 1;
+				}
+				else if (opt_eol::value && *s == '\r') // Either a single 0x0d or 0x0d 0x0a pair
+				{
+					*s++ = '\n'; // replace first one with 0x0a
+
+					if (*s == '\n') g.push(s, 1);
+				}
+				else if (opt_escape::value && *s == '&')
+				{
+					s = strconv_escape(s, g);
+				}
+				else if (*s == 0)
+				{
+					char_t* end = g.flush(s);
+
+					if (opt_trim::value)
+						while (end > begin && PUGI_IMPL_IS_CHARTYPE(end[-1], ct_space))
+							--end;
+
+					*end = 0;
+
+					return s;
+				}
+				else ++s;
+			}
+		}
+	};
+
+	PUGI_IMPL_FN strconv_pcdata_t get_strconv_pcdata(unsigned int optmask)
+	{
+		PUGI_IMPL_STATIC_ASSERT(parse_escapes == 0x10 && parse_eol == 0x20 && parse_trim_pcdata == 0x0800);
+
+		switch (((optmask >> 4) & 3) | ((optmask >> 9) & 4)) // get bitmask for flags (trim eol escapes); this simultaneously checks 3 options from assertion above
+		{
+		case 0: return strconv_pcdata_impl<opt_false, opt_false, opt_false>::parse;
+		case 1: return strconv_pcdata_impl<opt_false, opt_false, opt_true>::parse;
+		case 2: return strconv_pcdata_impl<opt_false, opt_true, opt_false>::parse;
+		case 3: return strconv_pcdata_impl<opt_false, opt_true, opt_true>::parse;
+		case 4: return strconv_pcdata_impl<opt_true, opt_false, opt_false>::parse;
+		case 5: return strconv_pcdata_impl<opt_true, opt_false, opt_true>::parse;
+		case 6: return strconv_pcdata_impl<opt_true, opt_true, opt_false>::parse;
+		case 7: return strconv_pcdata_impl<opt_true, opt_true, opt_true>::parse;
+		default: assert(false); return 0; // unreachable
+		}
+	}
+
+	typedef char_t* (*strconv_attribute_t)(char_t*, char_t);
+
+	template <typename opt_escape> struct strconv_attribute_impl
+	{
+		static char_t* parse_wnorm(char_t* s, char_t end_quote)
+		{
+			gap g;
+
+			// trim leading whitespaces
+			if (PUGI_IMPL_IS_CHARTYPE(*s, ct_space))
+			{
+				char_t* str = s;
+
+				do ++str;
+				while (PUGI_IMPL_IS_CHARTYPE(*str, ct_space));
+
+				g.push(s, str - s);
+			}
+
+			while (true)
+			{
+				PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_attr_ws | ct_space));
+
+				if (*s == end_quote)
+				{
+					char_t* str = g.flush(s);
+
+					do *str-- = 0;
+					while (PUGI_IMPL_IS_CHARTYPE(*str, ct_space));
+
+					return s + 1;
+				}
+				else if (PUGI_IMPL_IS_CHARTYPE(*s, ct_space))
+				{
+					*s++ = ' ';
+
+					if (PUGI_IMPL_IS_CHARTYPE(*s, ct_space))
+					{
+						char_t* str = s + 1;
+						while (PUGI_IMPL_IS_CHARTYPE(*str, ct_space)) ++str;
+
+						g.push(s, str - s);
+					}
+				}
+				else if (opt_escape::value && *s == '&')
+				{
+					s = strconv_escape(s, g);
+				}
+				else if (!*s)
+				{
+					return 0;
+				}
+				else ++s;
+			}
+		}
+
+		static char_t* parse_wconv(char_t* s, char_t end_quote)
+		{
+			gap g;
+
+			while (true)
+			{
+				PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_attr_ws));
+
+				if (*s == end_quote)
+				{
+					*g.flush(s) = 0;
+
+					return s + 1;
+				}
+				else if (PUGI_IMPL_IS_CHARTYPE(*s, ct_space))
+				{
+					if (*s == '\r')
+					{
+						*s++ = ' ';
+
+						if (*s == '\n') g.push(s, 1);
+					}
+					else *s++ = ' ';
+				}
+				else if (opt_escape::value && *s == '&')
+				{
+					s = strconv_escape(s, g);
+				}
+				else if (!*s)
+				{
+					return 0;
+				}
+				else ++s;
+			}
+		}
+
+		static char_t* parse_eol(char_t* s, char_t end_quote)
+		{
+			gap g;
+
+			while (true)
+			{
+				PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_attr));
+
+				if (*s == end_quote)
+				{
+					*g.flush(s) = 0;
+
+					return s + 1;
+				}
+				else if (*s == '\r')
+				{
+					*s++ = '\n';
+
+					if (*s == '\n') g.push(s, 1);
+				}
+				else if (opt_escape::value && *s == '&')
+				{
+					s = strconv_escape(s, g);
+				}
+				else if (!*s)
+				{
+					return 0;
+				}
+				else ++s;
+			}
+		}
+
+		static char_t* parse_simple(char_t* s, char_t end_quote)
+		{
+			gap g;
+
+			while (true)
+			{
+				PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_attr));
+
+				if (*s == end_quote)
+				{
+					*g.flush(s) = 0;
+
+					return s + 1;
+				}
+				else if (opt_escape::value && *s == '&')
+				{
+					s = strconv_escape(s, g);
+				}
+				else if (!*s)
+				{
+					return 0;
+				}
+				else ++s;
+			}
+		}
+	};
+
+	PUGI_IMPL_FN strconv_attribute_t get_strconv_attribute(unsigned int optmask)
+	{
+		PUGI_IMPL_STATIC_ASSERT(parse_escapes == 0x10 && parse_eol == 0x20 && parse_wconv_attribute == 0x40 && parse_wnorm_attribute == 0x80);
+
+		switch ((optmask >> 4) & 15) // get bitmask for flags (wnorm wconv eol escapes); this simultaneously checks 4 options from assertion above
+		{
+		case 0:  return strconv_attribute_impl<opt_false>::parse_simple;
+		case 1:  return strconv_attribute_impl<opt_true>::parse_simple;
+		case 2:  return strconv_attribute_impl<opt_false>::parse_eol;
+		case 3:  return strconv_attribute_impl<opt_true>::parse_eol;
+		case 4:  return strconv_attribute_impl<opt_false>::parse_wconv;
+		case 5:  return strconv_attribute_impl<opt_true>::parse_wconv;
+		case 6:  return strconv_attribute_impl<opt_false>::parse_wconv;
+		case 7:  return strconv_attribute_impl<opt_true>::parse_wconv;
+		case 8:  return strconv_attribute_impl<opt_false>::parse_wnorm;
+		case 9:  return strconv_attribute_impl<opt_true>::parse_wnorm;
+		case 10: return strconv_attribute_impl<opt_false>::parse_wnorm;
+		case 11: return strconv_attribute_impl<opt_true>::parse_wnorm;
+		case 12: return strconv_attribute_impl<opt_false>::parse_wnorm;
+		case 13: return strconv_attribute_impl<opt_true>::parse_wnorm;
+		case 14: return strconv_attribute_impl<opt_false>::parse_wnorm;
+		case 15: return strconv_attribute_impl<opt_true>::parse_wnorm;
+		default: assert(false); return 0; // unreachable
+		}
+	}
+
+	inline xml_parse_result make_parse_result(xml_parse_status status, ptrdiff_t offset = 0)
+	{
+		xml_parse_result result;
+		result.status = status;
+		result.offset = offset;
+
+		return result;
+	}
+
+	struct xml_parser
+	{
+		xml_allocator* alloc;
+		char_t* error_offset;
+		xml_parse_status error_status;
+
+		xml_parser(xml_allocator* alloc_): alloc(alloc_), error_offset(0), error_status(status_ok)
+		{
+		}
+
+		// DOCTYPE consists of nested sections of the following possible types:
+		// <!-- ... -->, <? ... ?>, "...", '...'
+		// <![...]]>
+		// <!...>
+		// First group can not contain nested groups
+		// Second group can contain nested groups of the same type
+		// Third group can contain all other groups
+		char_t* parse_doctype_primitive(char_t* s)
+		{
+			if (*s == '"' || *s == '\'')
+			{
+				// quoted string
+				char_t ch = *s++;
+				PUGI_IMPL_SCANFOR(*s == ch);
+				if (!*s) PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+				s++;
+			}
+			else if (s[0] == '<' && s[1] == '?')
+			{
+				// <? ... ?>
+				s += 2;
+				PUGI_IMPL_SCANFOR(s[0] == '?' && s[1] == '>'); // no need for ENDSWITH because ?> can't terminate proper doctype
+				if (!*s) PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+				s += 2;
+			}
+			else if (s[0] == '<' && s[1] == '!' && s[2] == '-' && s[3] == '-')
+			{
+				s += 4;
+				PUGI_IMPL_SCANFOR(s[0] == '-' && s[1] == '-' && s[2] == '>'); // no need for ENDSWITH because --> can't terminate proper doctype
+				if (!*s) PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+				s += 3;
+			}
+			else PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+			return s;
+		}
+
+		char_t* parse_doctype_ignore(char_t* s)
+		{
+			size_t depth = 0;
+
+			assert(s[0] == '<' && s[1] == '!' && s[2] == '[');
+			s += 3;
+
+			while (*s)
+			{
+				if (s[0] == '<' && s[1] == '!' && s[2] == '[')
+				{
+					// nested ignore section
+					s += 3;
+					depth++;
+				}
+				else if (s[0] == ']' && s[1] == ']' && s[2] == '>')
+				{
+					// ignore section end
+					s += 3;
+
+					if (depth == 0)
+						return s;
+
+					depth--;
+				}
+				else s++;
+			}
+
+			PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+		}
+
+		char_t* parse_doctype_group(char_t* s, char_t endch)
+		{
+			size_t depth = 0;
+
+			assert((s[0] == '<' || s[0] == 0) && s[1] == '!');
+			s += 2;
+
+			while (*s)
+			{
+				if (s[0] == '<' && s[1] == '!' && s[2] != '-')
+				{
+					if (s[2] == '[')
+					{
+						// ignore
+						s = parse_doctype_ignore(s);
+						if (!s) return s;
+					}
+					else
+					{
+						// some control group
+						s += 2;
+						depth++;
+					}
+				}
+				else if (s[0] == '<' || s[0] == '"' || s[0] == '\'')
+				{
+					// unknown tag (forbidden), or some primitive group
+					s = parse_doctype_primitive(s);
+					if (!s) return s;
+				}
+				else if (*s == '>')
+				{
+					if (depth == 0)
+						return s;
+
+					depth--;
+					s++;
+				}
+				else s++;
+			}
+
+			if (depth != 0 || endch != '>') PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+			return s;
+		}
+
+		char_t* parse_exclamation(char_t* s, xml_node_struct* cursor, unsigned int optmsk, char_t endch)
+		{
+			// parse node contents, starting with exclamation mark
+			++s;
+
+			if (*s == '-') // '<!-...'
+			{
+				++s;
+
+				if (*s == '-') // '<!--...'
+				{
+					++s;
+
+					if (PUGI_IMPL_OPTSET(parse_comments))
+					{
+						PUGI_IMPL_PUSHNODE(node_comment); // Append a new node on the tree.
+						cursor->value = s; // Save the offset.
+					}
+
+					if (PUGI_IMPL_OPTSET(parse_eol) && PUGI_IMPL_OPTSET(parse_comments))
+					{
+						s = strconv_comment(s, endch);
+
+						if (!s) PUGI_IMPL_THROW_ERROR(status_bad_comment, cursor->value);
+					}
+					else
+					{
+						// Scan for terminating '-->'.
+						PUGI_IMPL_SCANFOR(s[0] == '-' && s[1] == '-' && PUGI_IMPL_ENDSWITH(s[2], '>'));
+						PUGI_IMPL_CHECK_ERROR(status_bad_comment, s);
+
+						if (PUGI_IMPL_OPTSET(parse_comments))
+							*s = 0; // Zero-terminate this segment at the first terminating '-'.
+
+						s += (s[2] == '>' ? 3 : 2); // Step over the '\0->'.
+					}
+				}
+				else PUGI_IMPL_THROW_ERROR(status_bad_comment, s);
+			}
+			else if (*s == '[')
+			{
+				// '<![CDATA[...'
+				if (*++s=='C' && *++s=='D' && *++s=='A' && *++s=='T' && *++s=='A' && *++s == '[')
+				{
+					++s;
+
+					if (PUGI_IMPL_OPTSET(parse_cdata))
+					{
+						PUGI_IMPL_PUSHNODE(node_cdata); // Append a new node on the tree.
+						cursor->value = s; // Save the offset.
+
+						if (PUGI_IMPL_OPTSET(parse_eol))
+						{
+							s = strconv_cdata(s, endch);
+
+							if (!s) PUGI_IMPL_THROW_ERROR(status_bad_cdata, cursor->value);
+						}
+						else
+						{
+							// Scan for terminating ']]>'.
+							PUGI_IMPL_SCANFOR(s[0] == ']' && s[1] == ']' && PUGI_IMPL_ENDSWITH(s[2], '>'));
+							PUGI_IMPL_CHECK_ERROR(status_bad_cdata, s);
+
+							*s++ = 0; // Zero-terminate this segment.
+						}
+					}
+					else // Flagged for discard, but we still have to scan for the terminator.
+					{
+						// Scan for terminating ']]>'.
+						PUGI_IMPL_SCANFOR(s[0] == ']' && s[1] == ']' && PUGI_IMPL_ENDSWITH(s[2], '>'));
+						PUGI_IMPL_CHECK_ERROR(status_bad_cdata, s);
+
+						++s;
+					}
+
+					s += (s[1] == '>' ? 2 : 1); // Step over the last ']>'.
+				}
+				else PUGI_IMPL_THROW_ERROR(status_bad_cdata, s);
+			}
+			else if (s[0] == 'D' && s[1] == 'O' && s[2] == 'C' && s[3] == 'T' && s[4] == 'Y' && s[5] == 'P' && PUGI_IMPL_ENDSWITH(s[6], 'E'))
+			{
+				s -= 2;
+
+				if (cursor->parent) PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+				char_t* mark = s + 9;
+
+				s = parse_doctype_group(s, endch);
+				if (!s) return s;
+
+				assert((*s == 0 && endch == '>') || *s == '>');
+				if (*s) *s++ = 0;
+
+				if (PUGI_IMPL_OPTSET(parse_doctype))
+				{
+					while (PUGI_IMPL_IS_CHARTYPE(*mark, ct_space)) ++mark;
+
+					PUGI_IMPL_PUSHNODE(node_doctype);
+
+					cursor->value = mark;
+				}
+			}
+			else if (*s == 0 && endch == '-') PUGI_IMPL_THROW_ERROR(status_bad_comment, s);
+			else if (*s == 0 && endch == '[') PUGI_IMPL_THROW_ERROR(status_bad_cdata, s);
+			else PUGI_IMPL_THROW_ERROR(status_unrecognized_tag, s);
+
+			return s;
+		}
+
+		char_t* parse_question(char_t* s, xml_node_struct*& ref_cursor, unsigned int optmsk, char_t endch)
+		{
+			// load into registers
+			xml_node_struct* cursor = ref_cursor;
+			char_t ch = 0;
+
+			// parse node contents, starting with question mark
+			++s;
+
+			// read PI target
+			char_t* target = s;
+
+			if (!PUGI_IMPL_IS_CHARTYPE(*s, ct_start_symbol)) PUGI_IMPL_THROW_ERROR(status_bad_pi, s);
+
+			PUGI_IMPL_SCANWHILE(PUGI_IMPL_IS_CHARTYPE(*s, ct_symbol));
+			PUGI_IMPL_CHECK_ERROR(status_bad_pi, s);
+
+			// determine node type; stricmp / strcasecmp is not portable
+			bool declaration = (target[0] | ' ') == 'x' && (target[1] | ' ') == 'm' && (target[2] | ' ') == 'l' && target + 3 == s;
+
+			if (declaration ? PUGI_IMPL_OPTSET(parse_declaration) : PUGI_IMPL_OPTSET(parse_pi))
+			{
+				if (declaration)
+				{
+					// disallow non top-level declarations
+					if (cursor->parent) PUGI_IMPL_THROW_ERROR(status_bad_pi, s);
+
+					PUGI_IMPL_PUSHNODE(node_declaration);
+				}
+				else
+				{
+					PUGI_IMPL_PUSHNODE(node_pi);
+				}
+
+				cursor->name = target;
+
+				PUGI_IMPL_ENDSEG();
+
+				// parse value/attributes
+				if (ch == '?')
+				{
+					// empty node
+					if (!PUGI_IMPL_ENDSWITH(*s, '>')) PUGI_IMPL_THROW_ERROR(status_bad_pi, s);
+					s += (*s == '>');
+
+					PUGI_IMPL_POPNODE();
+				}
+				else if (PUGI_IMPL_IS_CHARTYPE(ch, ct_space))
+				{
+					PUGI_IMPL_SKIPWS();
+
+					// scan for tag end
+					char_t* value = s;
+
+					PUGI_IMPL_SCANFOR(s[0] == '?' && PUGI_IMPL_ENDSWITH(s[1], '>'));
+					PUGI_IMPL_CHECK_ERROR(status_bad_pi, s);
+
+					if (declaration)
+					{
+						// replace ending ? with / so that 'element' terminates properly
+						*s = '/';
+
+						// we exit from this function with cursor at node_declaration, which is a signal to parse() to go to LOC_ATTRIBUTES
+						s = value;
+					}
+					else
+					{
+						// store value and step over >
+						cursor->value = value;
+
+						PUGI_IMPL_POPNODE();
+
+						PUGI_IMPL_ENDSEG();
+
+						s += (*s == '>');
+					}
+				}
+				else PUGI_IMPL_THROW_ERROR(status_bad_pi, s);
+			}
+			else
+			{
+				// scan for tag end
+				PUGI_IMPL_SCANFOR(s[0] == '?' && PUGI_IMPL_ENDSWITH(s[1], '>'));
+				PUGI_IMPL_CHECK_ERROR(status_bad_pi, s);
+
+				s += (s[1] == '>' ? 2 : 1);
+			}
+
+			// store from registers
+			ref_cursor = cursor;
+
+			return s;
+		}
+
+		char_t* parse_tree(char_t* s, xml_node_struct* root, unsigned int optmsk, char_t endch)
+		{
+			strconv_attribute_t strconv_attribute = get_strconv_attribute(optmsk);
+			strconv_pcdata_t strconv_pcdata = get_strconv_pcdata(optmsk);
+
+			char_t ch = 0;
+			xml_node_struct* cursor = root;
+			char_t* mark = s;
+			char_t* merged_pcdata = s;
+
+			while (*s != 0)
+			{
+				if (*s == '<')
+				{
+					++s;
+
+				LOC_TAG:
+					if (PUGI_IMPL_IS_CHARTYPE(*s, ct_start_symbol)) // '<#...'
+					{
+						PUGI_IMPL_PUSHNODE(node_element); // Append a new node to the tree.
+
+						cursor->name = s;
+
+						PUGI_IMPL_SCANWHILE_UNROLL(PUGI_IMPL_IS_CHARTYPE(ss, ct_symbol)); // Scan for a terminator.
+						PUGI_IMPL_ENDSEG(); // Save char in 'ch', terminate & step over.
+
+						if (ch == '>')
+						{
+							// end of tag
+						}
+						else if (PUGI_IMPL_IS_CHARTYPE(ch, ct_space))
+						{
+						LOC_ATTRIBUTES:
+							while (true)
+							{
+								PUGI_IMPL_SKIPWS(); // Eat any whitespace.
+
+								if (PUGI_IMPL_IS_CHARTYPE(*s, ct_start_symbol)) // <... #...
+								{
+									xml_attribute_struct* a = append_new_attribute(cursor, *alloc); // Make space for this attribute.
+									if (!a) PUGI_IMPL_THROW_ERROR(status_out_of_memory, s);
+
+									a->name = s; // Save the offset.
+
+									PUGI_IMPL_SCANWHILE_UNROLL(PUGI_IMPL_IS_CHARTYPE(ss, ct_symbol)); // Scan for a terminator.
+									PUGI_IMPL_ENDSEG(); // Save char in 'ch', terminate & step over.
+
+									if (PUGI_IMPL_IS_CHARTYPE(ch, ct_space))
+									{
+										PUGI_IMPL_SKIPWS(); // Eat any whitespace.
+
+										ch = *s;
+										++s;
+									}
+
+									if (ch == '=') // '<... #=...'
+									{
+										PUGI_IMPL_SKIPWS(); // Eat any whitespace.
+
+										if (*s == '"' || *s == '\'') // '<... #="...'
+										{
+											ch = *s; // Save quote char to avoid breaking on "''" -or- '""'.
+											++s; // Step over the quote.
+											a->value = s; // Save the offset.
+
+											s = strconv_attribute(s, ch);
+
+											if (!s) PUGI_IMPL_THROW_ERROR(status_bad_attribute, a->value);
+
+											// After this line the loop continues from the start;
+											// Whitespaces, / and > are ok, symbols and EOF are wrong,
+											// everything else will be detected
+											if (PUGI_IMPL_IS_CHARTYPE(*s, ct_start_symbol)) PUGI_IMPL_THROW_ERROR(status_bad_attribute, s);
+										}
+										else PUGI_IMPL_THROW_ERROR(status_bad_attribute, s);
+									}
+									else PUGI_IMPL_THROW_ERROR(status_bad_attribute, s);
+								}
+								else if (*s == '/')
+								{
+									++s;
+
+									if (*s == '>')
+									{
+										PUGI_IMPL_POPNODE();
+										s++;
+										break;
+									}
+									else if (*s == 0 && endch == '>')
+									{
+										PUGI_IMPL_POPNODE();
+										break;
+									}
+									else PUGI_IMPL_THROW_ERROR(status_bad_start_element, s);
+								}
+								else if (*s == '>')
+								{
+									++s;
+
+									break;
+								}
+								else if (*s == 0 && endch == '>')
+								{
+									break;
+								}
+								else PUGI_IMPL_THROW_ERROR(status_bad_start_element, s);
+							}
+
+							// !!!
+						}
+						else if (ch == '/') // '<#.../'
+						{
+							if (!PUGI_IMPL_ENDSWITH(*s, '>')) PUGI_IMPL_THROW_ERROR(status_bad_start_element, s);
+
+							PUGI_IMPL_POPNODE(); // Pop.
+
+							s += (*s == '>');
+						}
+						else if (ch == 0)
+						{
+							// we stepped over null terminator, backtrack & handle closing tag
+							--s;
+
+							if (endch != '>') PUGI_IMPL_THROW_ERROR(status_bad_start_element, s);
+						}
+						else PUGI_IMPL_THROW_ERROR(status_bad_start_element, s);
+					}
+					else if (*s == '/')
+					{
+						++s;
+
+						mark = s;
+
+						char_t* name = cursor->name;
+						if (!name) PUGI_IMPL_THROW_ERROR(status_end_element_mismatch, mark);
+
+						while (PUGI_IMPL_IS_CHARTYPE(*s, ct_symbol))
+						{
+							if (*s++ != *name++) PUGI_IMPL_THROW_ERROR(status_end_element_mismatch, mark);
+						}
+
+						if (*name)
+						{
+							if (*s == 0 && name[0] == endch && name[1] == 0) PUGI_IMPL_THROW_ERROR(status_bad_end_element, s);
+							else PUGI_IMPL_THROW_ERROR(status_end_element_mismatch, mark);
+						}
+
+						PUGI_IMPL_POPNODE(); // Pop.
+
+						PUGI_IMPL_SKIPWS();
+
+						if (*s == 0)
+						{
+							if (endch != '>') PUGI_IMPL_THROW_ERROR(status_bad_end_element, s);
+						}
+						else
+						{
+							if (*s != '>') PUGI_IMPL_THROW_ERROR(status_bad_end_element, s);
+							++s;
+						}
+					}
+					else if (*s == '?') // '<?...'
+					{
+						s = parse_question(s, cursor, optmsk, endch);
+						if (!s) return s;
+
+						assert(cursor);
+						if (PUGI_IMPL_NODETYPE(cursor) == node_declaration) goto LOC_ATTRIBUTES;
+					}
+					else if (*s == '!') // '<!...'
+					{
+						s = parse_exclamation(s, cursor, optmsk, endch);
+						if (!s) return s;
+					}
+					else if (*s == 0 && endch == '?') PUGI_IMPL_THROW_ERROR(status_bad_pi, s);
+					else PUGI_IMPL_THROW_ERROR(status_unrecognized_tag, s);
+				}
+				else
+				{
+					mark = s; // Save this offset while searching for a terminator.
+
+					PUGI_IMPL_SKIPWS(); // Eat whitespace if no genuine PCDATA here.
+
+					if (*s == '<' || !*s)
+					{
+						// We skipped some whitespace characters because otherwise we would take the tag branch instead of PCDATA one
+						assert(mark != s);
+
+						if (!PUGI_IMPL_OPTSET(parse_ws_pcdata | parse_ws_pcdata_single) || PUGI_IMPL_OPTSET(parse_trim_pcdata))
+						{
+							continue;
+						}
+						else if (PUGI_IMPL_OPTSET(parse_ws_pcdata_single))
+						{
+							if (s[0] != '<' || s[1] != '/' || cursor->first_child) continue;
+						}
+					}
+
+					if (!PUGI_IMPL_OPTSET(parse_trim_pcdata))
+						s = mark;
+
+					if (cursor->parent || PUGI_IMPL_OPTSET(parse_fragment))
+					{
+						char_t* parsed_pcdata = s;
+
+						s = strconv_pcdata(s);
+
+						if (PUGI_IMPL_OPTSET(parse_embed_pcdata) && cursor->parent && !cursor->first_child && !cursor->value)
+						{
+							cursor->value = parsed_pcdata; // Save the offset.
+						}
+						else if (PUGI_IMPL_OPTSET(parse_merge_pcdata) && cursor->first_child && PUGI_IMPL_NODETYPE(cursor->first_child->prev_sibling_c) == node_pcdata)
+						{
+							assert(merged_pcdata >= cursor->first_child->prev_sibling_c->value);
+
+							// Catch up to the end of last parsed value; only needed for the first fragment.
+							merged_pcdata += strlength(merged_pcdata);
+
+							size_t length = strlength(parsed_pcdata);
+
+							// Must use memmove instead of memcpy as this move may overlap
+							memmove(merged_pcdata, parsed_pcdata, (length + 1) * sizeof(char_t));
+							merged_pcdata += length;
+						}
+						else
+						{
+							xml_node_struct* prev_cursor = cursor;
+							PUGI_IMPL_PUSHNODE(node_pcdata); // Append a new node on the tree.
+
+							cursor->value = parsed_pcdata; // Save the offset.
+							merged_pcdata = parsed_pcdata; // Used for parse_merge_pcdata above, cheaper to save unconditionally
+
+							cursor = prev_cursor; // Pop since this is a standalone.
+						}
+
+						if (!*s) break;
+					}
+					else
+					{
+						PUGI_IMPL_SCANFOR(*s == '<'); // '...<'
+						if (!*s) break;
+
+						++s;
+					}
+
+					// We're after '<'
+					goto LOC_TAG;
+				}
+			}
+
+			// check that last tag is closed
+			if (cursor != root) PUGI_IMPL_THROW_ERROR(status_end_element_mismatch, s);
+
+			return s;
+		}
+
+	#ifdef PUGIXML_WCHAR_MODE
+		static char_t* parse_skip_bom(char_t* s)
+		{
+			unsigned int bom = 0xfeff;
+			return (s[0] == static_cast<wchar_t>(bom)) ? s + 1 : s;
+		}
+	#else
+		static char_t* parse_skip_bom(char_t* s)
+		{
+			return (s[0] == '\xef' && s[1] == '\xbb' && s[2] == '\xbf') ? s + 3 : s;
+		}
+	#endif
+
+		static bool has_element_node_siblings(xml_node_struct* node)
+		{
+			while (node)
+			{
+				if (PUGI_IMPL_NODETYPE(node) == node_element) return true;
+
+				node = node->next_sibling;
+			}
+
+			return false;
+		}
+
+		static xml_parse_result parse(char_t* buffer, size_t length, xml_document_struct* xmldoc, xml_node_struct* root, unsigned int optmsk)
+		{
+			// early-out for empty documents
+			if (length == 0)
+				return make_parse_result(PUGI_IMPL_OPTSET(parse_fragment) ? status_ok : status_no_document_element);
+
+			// get last child of the root before parsing
+			xml_node_struct* last_root_child = root->first_child ? root->first_child->prev_sibling_c + 0 : 0;
+
+			// create parser on stack
+			xml_parser parser(static_cast<xml_allocator*>(xmldoc));
+
+			// save last character and make buffer zero-terminated (speeds up parsing)
+			char_t endch = buffer[length - 1];
+			buffer[length - 1] = 0;
+
+			// skip BOM to make sure it does not end up as part of parse output
+			char_t* buffer_data = parse_skip_bom(buffer);
+
+			// perform actual parsing
+			parser.parse_tree(buffer_data, root, optmsk, endch);
+
+			xml_parse_result result = make_parse_result(parser.error_status, parser.error_offset ? parser.error_offset - buffer : 0);
+			assert(result.offset >= 0 && static_cast<size_t>(result.offset) <= length);
+
+			if (result)
+			{
+				// since we removed last character, we have to handle the only possible false positive (stray <)
+				if (endch == '<')
+					return make_parse_result(status_unrecognized_tag, length - 1);
+
+				// check if there are any element nodes parsed
+				xml_node_struct* first_root_child_parsed = last_root_child ? last_root_child->next_sibling + 0 : root->first_child + 0;
+
+				if (!PUGI_IMPL_OPTSET(parse_fragment) && !has_element_node_siblings(first_root_child_parsed))
+					return make_parse_result(status_no_document_element, length - 1);
+			}
+			else
+			{
+				// roll back offset if it occurs on a null terminator in the source buffer
+				if (result.offset > 0 && static_cast<size_t>(result.offset) == length - 1 && endch == 0)
+					result.offset--;
+			}
+
+			return result;
+		}
+	};
+
+	// Output facilities
+	PUGI_IMPL_FN xml_encoding get_write_native_encoding()
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		return get_wchar_encoding();
+	#else
+		return encoding_utf8;
+	#endif
+	}
+
+	PUGI_IMPL_FN xml_encoding get_write_encoding(xml_encoding encoding)
+	{
+		// replace wchar encoding with utf implementation
+		if (encoding == encoding_wchar) return get_wchar_encoding();
+
+		// replace utf16 encoding with utf16 with specific endianness
+		if (encoding == encoding_utf16) return is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+		// replace utf32 encoding with utf32 with specific endianness
+		if (encoding == encoding_utf32) return is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+		// only do autodetection if no explicit encoding is requested
+		if (encoding != encoding_auto) return encoding;
+
+		// assume utf8 encoding
+		return encoding_utf8;
+	}
+
+	template <typename D, typename T> PUGI_IMPL_FN size_t convert_buffer_output_generic(typename T::value_type dest, const char_t* data, size_t length, D, T)
+	{
+		PUGI_IMPL_STATIC_ASSERT(sizeof(char_t) == sizeof(typename D::type));
+
+		typename T::value_type end = D::process(reinterpret_cast<const typename D::type*>(data), length, dest, T());
+
+		return static_cast<size_t>(end - dest) * sizeof(*dest);
+	}
+
+	template <typename D, typename T> PUGI_IMPL_FN size_t convert_buffer_output_generic(typename T::value_type dest, const char_t* data, size_t length, D, T, bool opt_swap)
+	{
+		PUGI_IMPL_STATIC_ASSERT(sizeof(char_t) == sizeof(typename D::type));
+
+		typename T::value_type end = D::process(reinterpret_cast<const typename D::type*>(data), length, dest, T());
+
+		if (opt_swap)
+		{
+			for (typename T::value_type i = dest; i != end; ++i)
+				*i = endian_swap(*i);
+		}
+
+		return static_cast<size_t>(end - dest) * sizeof(*dest);
+	}
+
+#ifdef PUGIXML_WCHAR_MODE
+	PUGI_IMPL_FN size_t get_valid_length(const char_t* data, size_t length)
+	{
+		if (length < 1) return 0;
+
+		// discard last character if it's the lead of a surrogate pair
+		return (sizeof(wchar_t) == 2 && static_cast<unsigned int>(static_cast<uint16_t>(data[length - 1]) - 0xD800) < 0x400) ? length - 1 : length;
+	}
+
+	PUGI_IMPL_FN size_t convert_buffer_output(char_t* r_char, uint8_t* r_u8, uint16_t* r_u16, uint32_t* r_u32, const char_t* data, size_t length, xml_encoding encoding)
+	{
+		// only endian-swapping is required
+		if (need_endian_swap_utf(encoding, get_wchar_encoding()))
+		{
+			convert_wchar_endian_swap(r_char, data, length);
+
+			return length * sizeof(char_t);
+		}
+
+		// convert to utf8
+		if (encoding == encoding_utf8)
+			return convert_buffer_output_generic(r_u8, data, length, wchar_decoder(), utf8_writer());
+
+		// convert to utf16
+		if (encoding == encoding_utf16_be || encoding == encoding_utf16_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+			return convert_buffer_output_generic(r_u16, data, length, wchar_decoder(), utf16_writer(), native_encoding != encoding);
+		}
+
+		// convert to utf32
+		if (encoding == encoding_utf32_be || encoding == encoding_utf32_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+			return convert_buffer_output_generic(r_u32, data, length, wchar_decoder(), utf32_writer(), native_encoding != encoding);
+		}
+
+		// convert to latin1
+		if (encoding == encoding_latin1)
+			return convert_buffer_output_generic(r_u8, data, length, wchar_decoder(), latin1_writer());
+
+		assert(false && "Invalid encoding"); // unreachable
+		return 0;
+	}
+#else
+	PUGI_IMPL_FN size_t get_valid_length(const char_t* data, size_t length)
+	{
+		if (length < 5) return 0;
+
+		for (size_t i = 1; i <= 4; ++i)
+		{
+			uint8_t ch = static_cast<uint8_t>(data[length - i]);
+
+			// either a standalone character or a leading one
+			if ((ch & 0xc0) != 0x80) return length - i;
+		}
+
+		// there are four non-leading characters at the end, sequence tail is broken so might as well process the whole chunk
+		return length;
+	}
+
+	PUGI_IMPL_FN size_t convert_buffer_output(char_t* /* r_char */, uint8_t* r_u8, uint16_t* r_u16, uint32_t* r_u32, const char_t* data, size_t length, xml_encoding encoding)
+	{
+		if (encoding == encoding_utf16_be || encoding == encoding_utf16_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+			return convert_buffer_output_generic(r_u16, data, length, utf8_decoder(), utf16_writer(), native_encoding != encoding);
+		}
+
+		if (encoding == encoding_utf32_be || encoding == encoding_utf32_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+			return convert_buffer_output_generic(r_u32, data, length, utf8_decoder(), utf32_writer(), native_encoding != encoding);
+		}
+
+		if (encoding == encoding_latin1)
+			return convert_buffer_output_generic(r_u8, data, length, utf8_decoder(), latin1_writer());
+
+		assert(false && "Invalid encoding"); // unreachable
+		return 0;
+	}
+#endif
+
+	class xml_buffered_writer
+	{
+		xml_buffered_writer(const xml_buffered_writer&);
+		xml_buffered_writer& operator=(const xml_buffered_writer&);
+
+	public:
+		xml_buffered_writer(xml_writer& writer_, xml_encoding user_encoding): writer(writer_), bufsize(0), encoding(get_write_encoding(user_encoding))
+		{
+			PUGI_IMPL_STATIC_ASSERT(bufcapacity >= 8);
+		}
+
+		size_t flush()
+		{
+			flush(buffer, bufsize);
+			bufsize = 0;
+			return 0;
+		}
+
+		void flush(const char_t* data, size_t size)
+		{
+			if (size == 0) return;
+
+			// fast path, just write data
+			if (encoding == get_write_native_encoding())
+				writer.write(data, size * sizeof(char_t));
+			else
+			{
+				// convert chunk
+				size_t result = convert_buffer_output(scratch.data_char, scratch.data_u8, scratch.data_u16, scratch.data_u32, data, size, encoding);
+				assert(result <= sizeof(scratch));
+
+				// write data
+				writer.write(scratch.data_u8, result);
+			}
+		}
+
+		void write_direct(const char_t* data, size_t length)
+		{
+			// flush the remaining buffer contents
+			flush();
+
+			// handle large chunks
+			if (length > bufcapacity)
+			{
+				if (encoding == get_write_native_encoding())
+				{
+					// fast path, can just write data chunk
+					writer.write(data, length * sizeof(char_t));
+					return;
+				}
+
+				// need to convert in suitable chunks
+				while (length > bufcapacity)
+				{
+					// get chunk size by selecting such number of characters that are guaranteed to fit into scratch buffer
+					// and form a complete codepoint sequence (i.e. discard start of last codepoint if necessary)
+					size_t chunk_size = get_valid_length(data, bufcapacity);
+					assert(chunk_size);
+
+					// convert chunk and write
+					flush(data, chunk_size);
+
+					// iterate
+					data += chunk_size;
+					length -= chunk_size;
+				}
+
+				// small tail is copied below
+				bufsize = 0;
+			}
+
+			memcpy(buffer + bufsize, data, length * sizeof(char_t));
+			bufsize += length;
+		}
+
+		void write_buffer(const char_t* data, size_t length)
+		{
+			size_t offset = bufsize;
+
+			if (offset + length <= bufcapacity)
+			{
+				memcpy(buffer + offset, data, length * sizeof(char_t));
+				bufsize = offset + length;
+			}
+			else
+			{
+				write_direct(data, length);
+			}
+		}
+
+		void write_string(const char_t* data)
+		{
+			// write the part of the string that fits in the buffer
+			size_t offset = bufsize;
+
+			while (*data && offset < bufcapacity)
+				buffer[offset++] = *data++;
+
+			// write the rest
+			if (offset < bufcapacity)
+			{
+				bufsize = offset;
+			}
+			else
+			{
+				// backtrack a bit if we have split the codepoint
+				size_t length = offset - bufsize;
+				size_t extra = length - get_valid_length(data - length, length);
+
+				bufsize = offset - extra;
+
+				write_direct(data - extra, strlength(data) + extra);
+			}
+		}
+
+		void write(char_t d0)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 1) offset = flush();
+
+			buffer[offset + 0] = d0;
+			bufsize = offset + 1;
+		}
+
+		void write(char_t d0, char_t d1)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 2) offset = flush();
+
+			buffer[offset + 0] = d0;
+			buffer[offset + 1] = d1;
+			bufsize = offset + 2;
+		}
+
+		void write(char_t d0, char_t d1, char_t d2)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 3) offset = flush();
+
+			buffer[offset + 0] = d0;
+			buffer[offset + 1] = d1;
+			buffer[offset + 2] = d2;
+			bufsize = offset + 3;
+		}
+
+		void write(char_t d0, char_t d1, char_t d2, char_t d3)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 4) offset = flush();
+
+			buffer[offset + 0] = d0;
+			buffer[offset + 1] = d1;
+			buffer[offset + 2] = d2;
+			buffer[offset + 3] = d3;
+			bufsize = offset + 4;
+		}
+
+		void write(char_t d0, char_t d1, char_t d2, char_t d3, char_t d4)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 5) offset = flush();
+
+			buffer[offset + 0] = d0;
+			buffer[offset + 1] = d1;
+			buffer[offset + 2] = d2;
+			buffer[offset + 3] = d3;
+			buffer[offset + 4] = d4;
+			bufsize = offset + 5;
+		}
+
+		void write(char_t d0, char_t d1, char_t d2, char_t d3, char_t d4, char_t d5)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 6) offset = flush();
+
+			buffer[offset + 0] = d0;
+			buffer[offset + 1] = d1;
+			buffer[offset + 2] = d2;
+			buffer[offset + 3] = d3;
+			buffer[offset + 4] = d4;
+			buffer[offset + 5] = d5;
+			bufsize = offset + 6;
+		}
+
+		// utf8 maximum expansion: x4 (-> utf32)
+		// utf16 maximum expansion: x2 (-> utf32)
+		// utf32 maximum expansion: x1
+		enum
+		{
+			bufcapacitybytes =
+			#ifdef PUGIXML_MEMORY_OUTPUT_STACK
+				PUGIXML_MEMORY_OUTPUT_STACK
+			#else
+				10240
+			#endif
+			,
+			bufcapacity = bufcapacitybytes / (sizeof(char_t) + 4)
+		};
+
+		char_t buffer[bufcapacity];
+
+		union
+		{
+			uint8_t data_u8[4 * bufcapacity];
+			uint16_t data_u16[2 * bufcapacity];
+			uint32_t data_u32[bufcapacity];
+			char_t data_char[bufcapacity];
+		} scratch;
+
+		xml_writer& writer;
+		size_t bufsize;
+		xml_encoding encoding;
+	};
+
+	PUGI_IMPL_FN void text_output_escaped(xml_buffered_writer& writer, const char_t* s, chartypex_t type, unsigned int flags)
+	{
+		while (*s)
+		{
+			const char_t* prev = s;
+
+			// While *s is a usual symbol
+			PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPEX(ss, type));
+
+			writer.write_buffer(prev, static_cast<size_t>(s - prev));
+
+			switch (*s)
+			{
+				case 0: break;
+				case '&':
+					writer.write('&', 'a', 'm', 'p', ';');
+					++s;
+					break;
+				case '<':
+					writer.write('&', 'l', 't', ';');
+					++s;
+					break;
+				case '>':
+					writer.write('&', 'g', 't', ';');
+					++s;
+					break;
+				case '"':
+					if (flags & format_attribute_single_quote)
+						writer.write('"');
+					else
+						writer.write('&', 'q', 'u', 'o', 't', ';');
+					++s;
+					break;
+				case '\'':
+					if (flags & format_attribute_single_quote)
+						writer.write('&', 'a', 'p', 'o', 's', ';');
+					else
+						writer.write('\'');
+					++s;
+					break;
+				default: // s is not a usual symbol
+				{
+					unsigned int ch = static_cast<unsigned int>(*s++);
+					assert(ch < 32);
+
+					if (!(flags & format_skip_control_chars))
+						writer.write('&', '#', static_cast<char_t>((ch / 10) + '0'), static_cast<char_t>((ch % 10) + '0'), ';');
+				}
+			}
+		}
+	}
+
+	PUGI_IMPL_FN void text_output(xml_buffered_writer& writer, const char_t* s, chartypex_t type, unsigned int flags)
+	{
+		if (flags & format_no_escapes)
+			writer.write_string(s);
+		else
+			text_output_escaped(writer, s, type, flags);
+	}
+
+	PUGI_IMPL_FN void text_output_cdata(xml_buffered_writer& writer, const char_t* s)
+	{
+		do
+		{
+			writer.write('<', '!', '[', 'C', 'D');
+			writer.write('A', 'T', 'A', '[');
+
+			const char_t* prev = s;
+
+			// look for ]]> sequence - we can't output it as is since it terminates CDATA
+			while (*s && !(s[0] == ']' && s[1] == ']' && s[2] == '>')) ++s;
+
+			// skip ]] if we stopped at ]]>, > will go to the next CDATA section
+			if (*s) s += 2;
+
+			writer.write_buffer(prev, static_cast<size_t>(s - prev));
+
+			writer.write(']', ']', '>');
+		}
+		while (*s);
+	}
+
+	PUGI_IMPL_FN void text_output_indent(xml_buffered_writer& writer, const char_t* indent, size_t indent_length, unsigned int depth)
+	{
+		switch (indent_length)
+		{
+		case 1:
+		{
+			for (unsigned int i = 0; i < depth; ++i)
+				writer.write(indent[0]);
+			break;
+		}
+
+		case 2:
+		{
+			for (unsigned int i = 0; i < depth; ++i)
+				writer.write(indent[0], indent[1]);
+			break;
+		}
+
+		case 3:
+		{
+			for (unsigned int i = 0; i < depth; ++i)
+				writer.write(indent[0], indent[1], indent[2]);
+			break;
+		}
+
+		case 4:
+		{
+			for (unsigned int i = 0; i < depth; ++i)
+				writer.write(indent[0], indent[1], indent[2], indent[3]);
+			break;
+		}
+
+		default:
+		{
+			for (unsigned int i = 0; i < depth; ++i)
+				writer.write_buffer(indent, indent_length);
+		}
+		}
+	}
+
+	PUGI_IMPL_FN void node_output_comment(xml_buffered_writer& writer, const char_t* s)
+	{
+		writer.write('<', '!', '-', '-');
+
+		while (*s)
+		{
+			const char_t* prev = s;
+
+			// look for -\0 or -- sequence - we can't output it since -- is illegal in comment body
+			while (*s && !(s[0] == '-' && (s[1] == '-' || s[1] == 0))) ++s;
+
+			writer.write_buffer(prev, static_cast<size_t>(s - prev));
+
+			if (*s)
+			{
+				assert(*s == '-');
+
+				writer.write('-', ' ');
+				++s;
+			}
+		}
+
+		writer.write('-', '-', '>');
+	}
+
+	PUGI_IMPL_FN void node_output_pi_value(xml_buffered_writer& writer, const char_t* s)
+	{
+		while (*s)
+		{
+			const char_t* prev = s;
+
+			// look for ?> sequence - we can't output it since ?> terminates PI
+			while (*s && !(s[0] == '?' && s[1] == '>')) ++s;
+
+			writer.write_buffer(prev, static_cast<size_t>(s - prev));
+
+			if (*s)
+			{
+				assert(s[0] == '?' && s[1] == '>');
+
+				writer.write('?', ' ', '>');
+				s += 2;
+			}
+		}
+	}
+
+	PUGI_IMPL_FN void node_output_attributes(xml_buffered_writer& writer, xml_node_struct* node, const char_t* indent, size_t indent_length, unsigned int flags, unsigned int depth)
+	{
+		const char_t* default_name = PUGIXML_TEXT(":anonymous");
+		const char_t enquotation_char = (flags & format_attribute_single_quote) ? '\'' : '"';
+
+		for (xml_attribute_struct* a = node->first_attribute; a; a = a->next_attribute)
+		{
+			if ((flags & (format_indent_attributes | format_raw)) == format_indent_attributes)
+			{
+				writer.write('\n');
+
+				text_output_indent(writer, indent, indent_length, depth + 1);
+			}
+			else
+			{
+				writer.write(' ');
+			}
+
+			writer.write_string(a->name ? a->name + 0 : default_name);
+			writer.write('=', enquotation_char);
+
+			if (a->value)
+				text_output(writer, a->value, ctx_special_attr, flags);
+
+			writer.write(enquotation_char);
+		}
+	}
+
+	PUGI_IMPL_FN bool node_output_start(xml_buffered_writer& writer, xml_node_struct* node, const char_t* indent, size_t indent_length, unsigned int flags, unsigned int depth)
+	{
+		const char_t* default_name = PUGIXML_TEXT(":anonymous");
+		const char_t* name = node->name ? node->name + 0 : default_name;
+
+		writer.write('<');
+		writer.write_string(name);
+
+		if (node->first_attribute)
+			node_output_attributes(writer, node, indent, indent_length, flags, depth);
+
+		// element nodes can have value if parse_embed_pcdata was used
+		if (!node->value)
+		{
+			if (!node->first_child)
+			{
+				if (flags & format_no_empty_element_tags)
+				{
+					writer.write('>', '<', '/');
+					writer.write_string(name);
+					writer.write('>');
+
+					return false;
+				}
+				else
+				{
+					if ((flags & format_raw) == 0)
+						writer.write(' ');
+
+					writer.write('/', '>');
+
+					return false;
+				}
+			}
+			else
+			{
+				writer.write('>');
+
+				return true;
+			}
+		}
+		else
+		{
+			writer.write('>');
+
+			text_output(writer, node->value, ctx_special_pcdata, flags);
+
+			if (!node->first_child)
+			{
+				writer.write('<', '/');
+				writer.write_string(name);
+				writer.write('>');
+
+				return false;
+			}
+			else
+			{
+				return true;
+			}
+		}
+	}
+
+	PUGI_IMPL_FN void node_output_end(xml_buffered_writer& writer, xml_node_struct* node)
+	{
+		const char_t* default_name = PUGIXML_TEXT(":anonymous");
+		const char_t* name = node->name ? node->name + 0 : default_name;
+
+		writer.write('<', '/');
+		writer.write_string(name);
+		writer.write('>');
+	}
+
+	PUGI_IMPL_FN void node_output_simple(xml_buffered_writer& writer, xml_node_struct* node, unsigned int flags)
+	{
+		const char_t* default_name = PUGIXML_TEXT(":anonymous");
+
+		switch (PUGI_IMPL_NODETYPE(node))
+		{
+			case node_pcdata:
+				text_output(writer, node->value ? node->value + 0 : PUGIXML_TEXT(""), ctx_special_pcdata, flags);
+				break;
+
+			case node_cdata:
+				text_output_cdata(writer, node->value ? node->value + 0 : PUGIXML_TEXT(""));
+				break;
+
+			case node_comment:
+				node_output_comment(writer, node->value ? node->value + 0 : PUGIXML_TEXT(""));
+				break;
+
+			case node_pi:
+				writer.write('<', '?');
+				writer.write_string(node->name ? node->name + 0 : default_name);
+
+				if (node->value)
+				{
+					writer.write(' ');
+					node_output_pi_value(writer, node->value);
+				}
+
+				writer.write('?', '>');
+				break;
+
+			case node_declaration:
+				writer.write('<', '?');
+				writer.write_string(node->name ? node->name + 0 : default_name);
+				node_output_attributes(writer, node, PUGIXML_TEXT(""), 0, flags | format_raw, 0);
+				writer.write('?', '>');
+				break;
+
+			case node_doctype:
+				writer.write('<', '!', 'D', 'O', 'C');
+				writer.write('T', 'Y', 'P', 'E');
+
+				if (node->value)
+				{
+					writer.write(' ');
+					writer.write_string(node->value);
+				}
+
+				writer.write('>');
+				break;
+
+			default:
+				assert(false && "Invalid node type"); // unreachable
+		}
+	}
+
+	enum indent_flags_t
+	{
+		indent_newline = 1,
+		indent_indent = 2
+	};
+
+	PUGI_IMPL_FN void node_output(xml_buffered_writer& writer, xml_node_struct* root, const char_t* indent, unsigned int flags, unsigned int depth)
+	{
+		size_t indent_length = ((flags & (format_indent | format_indent_attributes)) && (flags & format_raw) == 0) ? strlength(indent) : 0;
+		unsigned int indent_flags = indent_indent;
+
+		xml_node_struct* node = root;
+
+		do
+		{
+			assert(node);
+
+			// begin writing current node
+			if (PUGI_IMPL_NODETYPE(node) == node_pcdata || PUGI_IMPL_NODETYPE(node) == node_cdata)
+			{
+				node_output_simple(writer, node, flags);
+
+				indent_flags = 0;
+			}
+			else
+			{
+				if ((indent_flags & indent_newline) && (flags & format_raw) == 0)
+					writer.write('\n');
+
+				if ((indent_flags & indent_indent) && indent_length)
+					text_output_indent(writer, indent, indent_length, depth);
+
+				if (PUGI_IMPL_NODETYPE(node) == node_element)
+				{
+					indent_flags = indent_newline | indent_indent;
+
+					if (node_output_start(writer, node, indent, indent_length, flags, depth))
+					{
+						// element nodes can have value if parse_embed_pcdata was used
+						if (node->value)
+							indent_flags = 0;
+
+						node = node->first_child;
+						depth++;
+						continue;
+					}
+				}
+				else if (PUGI_IMPL_NODETYPE(node) == node_document)
+				{
+					indent_flags = indent_indent;
+
+					if (node->first_child)
+					{
+						node = node->first_child;
+						continue;
+					}
+				}
+				else
+				{
+					node_output_simple(writer, node, flags);
+
+					indent_flags = indent_newline | indent_indent;
+				}
+			}
+
+			// continue to the next node
+			while (node != root)
+			{
+				if (node->next_sibling)
+				{
+					node = node->next_sibling;
+					break;
+				}
+
+				node = node->parent;
+
+				// write closing node
+				if (PUGI_IMPL_NODETYPE(node) == node_element)
+				{
+					depth--;
+
+					if ((indent_flags & indent_newline) && (flags & format_raw) == 0)
+						writer.write('\n');
+
+					if ((indent_flags & indent_indent) && indent_length)
+						text_output_indent(writer, indent, indent_length, depth);
+
+					node_output_end(writer, node);
+
+					indent_flags = indent_newline | indent_indent;
+				}
+			}
+		}
+		while (node != root);
+
+		if ((indent_flags & indent_newline) && (flags & format_raw) == 0)
+			writer.write('\n');
+	}
+
+	PUGI_IMPL_FN bool has_declaration(xml_node_struct* node)
+	{
+		for (xml_node_struct* child = node->first_child; child; child = child->next_sibling)
+		{
+			xml_node_type type = PUGI_IMPL_NODETYPE(child);
+
+			if (type == node_declaration) return true;
+			if (type == node_element) return false;
+		}
+
+		return false;
+	}
+
+	PUGI_IMPL_FN bool is_attribute_of(xml_attribute_struct* attr, xml_node_struct* node)
+	{
+		for (xml_attribute_struct* a = node->first_attribute; a; a = a->next_attribute)
+			if (a == attr)
+				return true;
+
+		return false;
+	}
+
+	PUGI_IMPL_FN bool allow_insert_attribute(xml_node_type parent)
+	{
+		return parent == node_element || parent == node_declaration;
+	}
+
+	PUGI_IMPL_FN bool allow_insert_child(xml_node_type parent, xml_node_type child)
+	{
+		if (parent != node_document && parent != node_element) return false;
+		if (child == node_document || child == node_null) return false;
+		if (parent != node_document && (child == node_declaration || child == node_doctype)) return false;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool allow_move(xml_node parent, xml_node child)
+	{
+		// check that child can be a child of parent
+		if (!allow_insert_child(parent.type(), child.type()))
+			return false;
+
+		// check that node is not moved between documents
+		if (parent.root() != child.root())
+			return false;
+
+		// check that new parent is not in the child subtree
+		xml_node cur = parent;
+
+		while (cur)
+		{
+			if (cur == child)
+				return false;
+
+			cur = cur.parent();
+		}
+
+		return true;
+	}
+
+	template <typename String, typename Header>
+	PUGI_IMPL_FN void node_copy_string(String& dest, Header& header, uintptr_t header_mask, char_t* source, Header& source_header, xml_allocator* alloc)
+	{
+		assert(!dest && (header & header_mask) == 0); // copies are performed into fresh nodes
+
+		if (source)
+		{
+			if (alloc && (source_header & header_mask) == 0)
+			{
+				dest = source;
+
+				// since strcpy_insitu can reuse document buffer memory we need to mark both source and dest as shared
+				header |= xml_memory_page_contents_shared_mask;
+				source_header |= xml_memory_page_contents_shared_mask;
+			}
+			else
+				strcpy_insitu(dest, header, header_mask, source, strlength(source));
+		}
+	}
+
+	PUGI_IMPL_FN void node_copy_contents(xml_node_struct* dn, xml_node_struct* sn, xml_allocator* shared_alloc)
+	{
+		node_copy_string(dn->name, dn->header, xml_memory_page_name_allocated_mask, sn->name, sn->header, shared_alloc);
+		node_copy_string(dn->value, dn->header, xml_memory_page_value_allocated_mask, sn->value, sn->header, shared_alloc);
+
+		for (xml_attribute_struct* sa = sn->first_attribute; sa; sa = sa->next_attribute)
+		{
+			xml_attribute_struct* da = append_new_attribute(dn, get_allocator(dn));
+
+			if (da)
+			{
+				node_copy_string(da->name, da->header, xml_memory_page_name_allocated_mask, sa->name, sa->header, shared_alloc);
+				node_copy_string(da->value, da->header, xml_memory_page_value_allocated_mask, sa->value, sa->header, shared_alloc);
+			}
+		}
+	}
+
+	PUGI_IMPL_FN void node_copy_tree(xml_node_struct* dn, xml_node_struct* sn)
+	{
+		xml_allocator& alloc = get_allocator(dn);
+		xml_allocator* shared_alloc = (&alloc == &get_allocator(sn)) ? &alloc : 0;
+
+		node_copy_contents(dn, sn, shared_alloc);
+
+		xml_node_struct* dit = dn;
+		xml_node_struct* sit = sn->first_child;
+
+		while (sit && sit != sn)
+		{
+			// loop invariant: dit is inside the subtree rooted at dn
+			assert(dit);
+
+			// when a tree is copied into one of the descendants, we need to skip that subtree to avoid an infinite loop
+			if (sit != dn)
+			{
+				xml_node_struct* copy = append_new_node(dit, alloc, PUGI_IMPL_NODETYPE(sit));
+
+				if (copy)
+				{
+					node_copy_contents(copy, sit, shared_alloc);
+
+					if (sit->first_child)
+					{
+						dit = copy;
+						sit = sit->first_child;
+						continue;
+					}
+				}
+			}
+
+			// continue to the next node
+			do
+			{
+				if (sit->next_sibling)
+				{
+					sit = sit->next_sibling;
+					break;
+				}
+
+				sit = sit->parent;
+				dit = dit->parent;
+
+				// loop invariant: dit is inside the subtree rooted at dn while sit is inside sn
+				assert(sit == sn || dit);
+			}
+			while (sit != sn);
+		}
+
+		assert(!sit || dit == dn->parent);
+	}
+
+	PUGI_IMPL_FN void node_copy_attribute(xml_attribute_struct* da, xml_attribute_struct* sa)
+	{
+		xml_allocator& alloc = get_allocator(da);
+		xml_allocator* shared_alloc = (&alloc == &get_allocator(sa)) ? &alloc : 0;
+
+		node_copy_string(da->name, da->header, xml_memory_page_name_allocated_mask, sa->name, sa->header, shared_alloc);
+		node_copy_string(da->value, da->header, xml_memory_page_value_allocated_mask, sa->value, sa->header, shared_alloc);
+	}
+
+	inline bool is_text_node(xml_node_struct* node)
+	{
+		xml_node_type type = PUGI_IMPL_NODETYPE(node);
+
+		return type == node_pcdata || type == node_cdata;
+	}
+
+	// get value with conversion functions
+	template <typename U> PUGI_IMPL_FN PUGI_IMPL_UNSIGNED_OVERFLOW U string_to_integer(const char_t* value, U minv, U maxv)
+	{
+		U result = 0;
+		const char_t* s = value;
+
+		while (PUGI_IMPL_IS_CHARTYPE(*s, ct_space))
+			s++;
+
+		bool negative = (*s == '-');
+
+		s += (*s == '+' || *s == '-');
+
+		bool overflow = false;
+
+		if (s[0] == '0' && (s[1] | ' ') == 'x')
+		{
+			s += 2;
+
+			// since overflow detection relies on length of the sequence skip leading zeros
+			while (*s == '0')
+				s++;
+
+			const char_t* start = s;
+
+			for (;;)
+			{
+				if (static_cast<unsigned>(*s - '0') < 10)
+					result = result * 16 + (*s - '0');
+				else if (static_cast<unsigned>((*s | ' ') - 'a') < 6)
+					result = result * 16 + ((*s | ' ') - 'a' + 10);
+				else
+					break;
+
+				s++;
+			}
+
+			size_t digits = static_cast<size_t>(s - start);
+
+			overflow = digits > sizeof(U) * 2;
+		}
+		else
+		{
+			// since overflow detection relies on length of the sequence skip leading zeros
+			while (*s == '0')
+				s++;
+
+			const char_t* start = s;
+
+			for (;;)
+			{
+				if (static_cast<unsigned>(*s - '0') < 10)
+					result = result * 10 + (*s - '0');
+				else
+					break;
+
+				s++;
+			}
+
+			size_t digits = static_cast<size_t>(s - start);
+
+			PUGI_IMPL_STATIC_ASSERT(sizeof(U) == 8 || sizeof(U) == 4 || sizeof(U) == 2);
+
+			const size_t max_digits10 = sizeof(U) == 8 ? 20 : sizeof(U) == 4 ? 10 : 5;
+			const char_t max_lead = sizeof(U) == 8 ? '1' : sizeof(U) == 4 ? '4' : '6';
+			const size_t high_bit = sizeof(U) * 8 - 1;
+
+			overflow = digits >= max_digits10 && !(digits == max_digits10 && (*start < max_lead || (*start == max_lead && result >> high_bit)));
+		}
+
+		if (negative)
+		{
+			// Workaround for crayc++ CC-3059: Expected no overflow in routine.
+		#ifdef _CRAYC
+			return (overflow || result > ~minv + 1) ? minv : ~result + 1;
+		#else
+			return (overflow || result > 0 - minv) ? minv : 0 - result;
+		#endif
+		}
+		else
+			return (overflow || result > maxv) ? maxv : result;
+	}
+
+	PUGI_IMPL_FN int get_value_int(const char_t* value)
+	{
+		return string_to_integer<unsigned int>(value, static_cast<unsigned int>(INT_MIN), INT_MAX);
+	}
+
+	PUGI_IMPL_FN unsigned int get_value_uint(const char_t* value)
+	{
+		return string_to_integer<unsigned int>(value, 0, UINT_MAX);
+	}
+
+	PUGI_IMPL_FN double get_value_double(const char_t* value)
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcstod(value, 0);
+	#else
+		return strtod(value, 0);
+	#endif
+	}
+
+	PUGI_IMPL_FN float get_value_float(const char_t* value)
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		return static_cast<float>(wcstod(value, 0));
+	#else
+		return static_cast<float>(strtod(value, 0));
+	#endif
+	}
+
+	PUGI_IMPL_FN bool get_value_bool(const char_t* value)
+	{
+		// only look at first char
+		char_t first = *value;
+
+		// 1*, t* (true), T* (True), y* (yes), Y* (YES)
+		return (first == '1' || first == 't' || first == 'T' || first == 'y' || first == 'Y');
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN long long get_value_llong(const char_t* value)
+	{
+		return string_to_integer<unsigned long long>(value, static_cast<unsigned long long>(LLONG_MIN), LLONG_MAX);
+	}
+
+	PUGI_IMPL_FN unsigned long long get_value_ullong(const char_t* value)
+	{
+		return string_to_integer<unsigned long long>(value, 0, ULLONG_MAX);
+	}
+#endif
+
+	template <typename U> PUGI_IMPL_FN PUGI_IMPL_UNSIGNED_OVERFLOW char_t* integer_to_string(char_t* begin, char_t* end, U value, bool negative)
+	{
+		char_t* result = end - 1;
+		U rest = negative ? 0 - value : value;
+
+		do
+		{
+			*result-- = static_cast<char_t>('0' + (rest % 10));
+			rest /= 10;
+		}
+		while (rest);
+
+		assert(result >= begin);
+		(void)begin;
+
+		*result = '-';
+
+		return result + !negative;
+	}
+
+	// set value with conversion functions
+	template <typename String, typename Header>
+	PUGI_IMPL_FN bool set_value_ascii(String& dest, Header& header, uintptr_t header_mask, char* buf)
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		char_t wbuf[128];
+		assert(strlen(buf) < sizeof(wbuf) / sizeof(wbuf[0]));
+
+		size_t offset = 0;
+		for (; buf[offset]; ++offset) wbuf[offset] = buf[offset];
+
+		return strcpy_insitu(dest, header, header_mask, wbuf, offset);
+	#else
+		return strcpy_insitu(dest, header, header_mask, buf, strlen(buf));
+	#endif
+	}
+
+	template <typename U, typename String, typename Header>
+	PUGI_IMPL_FN bool set_value_integer(String& dest, Header& header, uintptr_t header_mask, U value, bool negative)
+	{
+		char_t buf[64];
+		char_t* end = buf + sizeof(buf) / sizeof(buf[0]);
+		char_t* begin = integer_to_string(buf, end, value, negative);
+
+		return strcpy_insitu(dest, header, header_mask, begin, end - begin);
+	}
+
+	template <typename String, typename Header>
+	PUGI_IMPL_FN bool set_value_convert(String& dest, Header& header, uintptr_t header_mask, float value, int precision)
+	{
+		char buf[128];
+		PUGI_IMPL_SNPRINTF(buf, "%.*g", precision, double(value));
+
+		return set_value_ascii(dest, header, header_mask, buf);
+	}
+
+	template <typename String, typename Header>
+	PUGI_IMPL_FN bool set_value_convert(String& dest, Header& header, uintptr_t header_mask, double value, int precision)
+	{
+		char buf[128];
+		PUGI_IMPL_SNPRINTF(buf, "%.*g", precision, value);
+
+		return set_value_ascii(dest, header, header_mask, buf);
+	}
+
+	template <typename String, typename Header>
+	PUGI_IMPL_FN bool set_value_bool(String& dest, Header& header, uintptr_t header_mask, bool value)
+	{
+		return strcpy_insitu(dest, header, header_mask, value ? PUGIXML_TEXT("true") : PUGIXML_TEXT("false"), value ? 4 : 5);
+	}
+
+	PUGI_IMPL_FN xml_parse_result load_buffer_impl(xml_document_struct* doc, xml_node_struct* root, void* contents, size_t size, unsigned int options, xml_encoding encoding, bool is_mutable, bool own, char_t** out_buffer)
+	{
+		// check input buffer
+		if (!contents && size) return make_parse_result(status_io_error);
+
+		// get actual encoding
+		xml_encoding buffer_encoding = impl::get_buffer_encoding(encoding, contents, size);
+
+		// if convert_buffer below throws bad_alloc, we still need to deallocate contents if we own it
+		auto_deleter<void> contents_guard(own ? contents : 0, xml_memory::deallocate);
+
+		// get private buffer
+		char_t* buffer = 0;
+		size_t length = 0;
+
+		// coverity[var_deref_model]
+		if (!impl::convert_buffer(buffer, length, buffer_encoding, contents, size, is_mutable)) return impl::make_parse_result(status_out_of_memory);
+
+		// after this we either deallocate contents (below) or hold on to it via doc->buffer, so we don't need to guard it
+		contents_guard.release();
+
+		// delete original buffer if we performed a conversion
+		if (own && buffer != contents && contents) impl::xml_memory::deallocate(contents);
+
+		// grab onto buffer if it's our buffer, user is responsible for deallocating contents himself
+		if (own || buffer != contents) *out_buffer = buffer;
+
+		// store buffer for offset_debug
+		doc->buffer = buffer;
+
+		// parse
+		xml_parse_result res = impl::xml_parser::parse(buffer, length, doc, root, options);
+
+		// remember encoding
+		res.encoding = buffer_encoding;
+
+		return res;
+	}
+
+	// we need to get length of entire file to load it in memory; the only (relatively) sane way to do it is via seek/tell trick
+	PUGI_IMPL_FN xml_parse_status get_file_size(FILE* file, size_t& out_result)
+	{
+	#if defined(__linux__) || defined(__APPLE__)
+		// this simultaneously retrieves the file size and file mode (to guard against loading non-files)
+		struct stat st;
+		if (fstat(fileno(file), &st) != 0) return status_io_error;
+
+		// anything that's not a regular file doesn't have a coherent length
+		if (!S_ISREG(st.st_mode)) return status_io_error;
+
+		typedef off_t length_type;
+		length_type length = st.st_size;
+	#elif defined(PUGI_IMPL_MSVC_CRT_VERSION) && PUGI_IMPL_MSVC_CRT_VERSION >= 1400
+		// there are 64-bit versions of fseek/ftell, let's use them
+		typedef __int64 length_type;
+
+		_fseeki64(file, 0, SEEK_END);
+		length_type length = _ftelli64(file);
+		_fseeki64(file, 0, SEEK_SET);
+	#elif defined(__MINGW32__) && !defined(__NO_MINGW_LFS) && (!defined(__STRICT_ANSI__) || defined(__MINGW64_VERSION_MAJOR))
+		// there are 64-bit versions of fseek/ftell, let's use them
+		typedef off64_t length_type;
+
+		fseeko64(file, 0, SEEK_END);
+		length_type length = ftello64(file);
+		fseeko64(file, 0, SEEK_SET);
+	#else
+		// if this is a 32-bit OS, long is enough; if this is a unix system, long is 64-bit, which is enough; otherwise we can't do anything anyway.
+		typedef long length_type;
+
+		fseek(file, 0, SEEK_END);
+		length_type length = ftell(file);
+		fseek(file, 0, SEEK_SET);
+	#endif
+
+		// check for I/O errors
+		if (length < 0) return status_io_error;
+
+		// check for overflow
+		size_t result = static_cast<size_t>(length);
+
+		if (static_cast<length_type>(result) != length) return status_out_of_memory;
+
+		// finalize
+		out_result = result;
+
+		return status_ok;
+	}
+
+	// This function assumes that buffer has extra sizeof(char_t) writable bytes after size
+	PUGI_IMPL_FN size_t zero_terminate_buffer(void* buffer, size_t size, xml_encoding encoding)
+	{
+		// We only need to zero-terminate if encoding conversion does not do it for us
+	#ifdef PUGIXML_WCHAR_MODE
+		xml_encoding wchar_encoding = get_wchar_encoding();
+
+		if (encoding == wchar_encoding || need_endian_swap_utf(encoding, wchar_encoding))
+		{
+			size_t length = size / sizeof(char_t);
+
+			static_cast<char_t*>(buffer)[length] = 0;
+			return (length + 1) * sizeof(char_t);
+		}
+	#else
+		if (encoding == encoding_utf8)
+		{
+			static_cast<char*>(buffer)[size] = 0;
+			return size + 1;
+		}
+	#endif
+
+		return size;
+	}
+
+	PUGI_IMPL_FN xml_parse_result load_file_impl(xml_document_struct* doc, FILE* file, unsigned int options, xml_encoding encoding, char_t** out_buffer)
+	{
+		if (!file) return make_parse_result(status_file_not_found);
+
+		// get file size (can result in I/O errors)
+		size_t size = 0;
+		xml_parse_status size_status = get_file_size(file, size);
+		if (size_status != status_ok) return make_parse_result(size_status);
+
+		size_t max_suffix_size = sizeof(char_t);
+
+		// allocate buffer for the whole file
+		char* contents = static_cast<char*>(xml_memory::allocate(size + max_suffix_size));
+		if (!contents) return make_parse_result(status_out_of_memory);
+
+		// read file in memory
+		size_t read_size = fread(contents, 1, size, file);
+
+		if (read_size != size)
+		{
+			xml_memory::deallocate(contents);
+			return make_parse_result(status_io_error);
+		}
+
+		xml_encoding real_encoding = get_buffer_encoding(encoding, contents, size);
+
+		return load_buffer_impl(doc, doc, contents, zero_terminate_buffer(contents, size, real_encoding), options, real_encoding, true, true, out_buffer);
+	}
+
+	PUGI_IMPL_FN void close_file(FILE* file)
+	{
+		fclose(file);
+	}
+
+#ifndef PUGIXML_NO_STL
+	template <typename T> struct xml_stream_chunk
+	{
+		static xml_stream_chunk* create()
+		{
+			void* memory = xml_memory::allocate(sizeof(xml_stream_chunk));
+			if (!memory) return 0;
+
+			return new (memory) xml_stream_chunk();
+		}
+
+		static void destroy(xml_stream_chunk* chunk)
+		{
+			// free chunk chain
+			while (chunk)
+			{
+				xml_stream_chunk* next_ = chunk->next;
+
+				xml_memory::deallocate(chunk);
+
+				chunk = next_;
+			}
+		}
+
+		xml_stream_chunk(): next(0), size(0)
+		{
+		}
+
+		xml_stream_chunk* next;
+		size_t size;
+
+		T data[xml_memory_page_size / sizeof(T)];
+	};
+
+	template <typename T> PUGI_IMPL_FN xml_parse_status load_stream_data_noseek(std::basic_istream<T>& stream, void** out_buffer, size_t* out_size)
+	{
+		auto_deleter<xml_stream_chunk<T> > chunks(0, xml_stream_chunk<T>::destroy);
+
+		// read file to a chunk list
+		size_t total = 0;
+		xml_stream_chunk<T>* last = 0;
+
+		while (!stream.eof())
+		{
+			// allocate new chunk
+			xml_stream_chunk<T>* chunk = xml_stream_chunk<T>::create();
+			if (!chunk) return status_out_of_memory;
+
+			// append chunk to list
+			if (last) last = last->next = chunk;
+			else chunks.data = last = chunk;
+
+			// read data to chunk
+			stream.read(chunk->data, static_cast<std::streamsize>(sizeof(chunk->data) / sizeof(T)));
+			chunk->size = static_cast<size_t>(stream.gcount()) * sizeof(T);
+
+			// read may set failbit | eofbit in case gcount() is less than read length, so check for other I/O errors
+			if (stream.bad() || (!stream.eof() && stream.fail())) return status_io_error;
+
+			// guard against huge files (chunk size is small enough to make this overflow check work)
+			if (total + chunk->size < total) return status_out_of_memory;
+			total += chunk->size;
+		}
+
+		size_t max_suffix_size = sizeof(char_t);
+
+		// copy chunk list to a contiguous buffer
+		char* buffer = static_cast<char*>(xml_memory::allocate(total + max_suffix_size));
+		if (!buffer) return status_out_of_memory;
+
+		char* write = buffer;
+
+		for (xml_stream_chunk<T>* chunk = chunks.data; chunk; chunk = chunk->next)
+		{
+			assert(write + chunk->size <= buffer + total);
+			memcpy(write, chunk->data, chunk->size);
+			write += chunk->size;
+		}
+
+		assert(write == buffer + total);
+
+		// return buffer
+		*out_buffer = buffer;
+		*out_size = total;
+
+		return status_ok;
+	}
+
+	template <typename T> PUGI_IMPL_FN xml_parse_status load_stream_data_seek(std::basic_istream<T>& stream, void** out_buffer, size_t* out_size)
+	{
+		// get length of remaining data in stream
+		typename std::basic_istream<T>::pos_type pos = stream.tellg();
+		stream.seekg(0, std::ios::end);
+		std::streamoff length = stream.tellg() - pos;
+		stream.seekg(pos);
+
+		if (stream.fail() || pos < 0) return status_io_error;
+
+		// guard against huge files
+		size_t read_length = static_cast<size_t>(length);
+
+		if (static_cast<std::streamsize>(read_length) != length || length < 0) return status_out_of_memory;
+
+		size_t max_suffix_size = sizeof(char_t);
+
+		// read stream data into memory (guard against stream exceptions with buffer holder)
+		auto_deleter<void> buffer(xml_memory::allocate(read_length * sizeof(T) + max_suffix_size), xml_memory::deallocate);
+		if (!buffer.data) return status_out_of_memory;
+
+		stream.read(static_cast<T*>(buffer.data), static_cast<std::streamsize>(read_length));
+
+		// read may set failbit | eofbit in case gcount() is less than read_length (i.e. line ending conversion), so check for other I/O errors
+		if (stream.bad() || (!stream.eof() && stream.fail())) return status_io_error;
+
+		// return buffer
+		size_t actual_length = static_cast<size_t>(stream.gcount());
+		assert(actual_length <= read_length);
+
+		*out_buffer = buffer.release();
+		*out_size = actual_length * sizeof(T);
+
+		return status_ok;
+	}
+
+	template <typename T> PUGI_IMPL_FN xml_parse_result load_stream_impl(xml_document_struct* doc, std::basic_istream<T>& stream, unsigned int options, xml_encoding encoding, char_t** out_buffer)
+	{
+		void* buffer = 0;
+		size_t size = 0;
+		xml_parse_status status = status_ok;
+
+		// if stream has an error bit set, bail out (otherwise tellg() can fail and we'll clear error bits)
+		if (stream.fail()) return make_parse_result(status_io_error);
+
+		// load stream to memory (using seek-based implementation if possible, since it's faster and takes less memory)
+		if (stream.tellg() < 0)
+		{
+			stream.clear(); // clear error flags that could be set by a failing tellg
+			status = load_stream_data_noseek(stream, &buffer, &size);
+		}
+		else
+			status = load_stream_data_seek(stream, &buffer, &size);
+
+		if (status != status_ok) return make_parse_result(status);
+
+		xml_encoding real_encoding = get_buffer_encoding(encoding, buffer, size);
+
+		return load_buffer_impl(doc, doc, buffer, zero_terminate_buffer(buffer, size, real_encoding), options, real_encoding, true, true, out_buffer);
+	}
+#endif
+
+#if defined(PUGI_IMPL_MSVC_CRT_VERSION) || defined(__BORLANDC__) || (defined(__MINGW32__) && (!defined(__STRICT_ANSI__) || defined(__MINGW64_VERSION_MAJOR)))
+	PUGI_IMPL_FN FILE* open_file_wide(const wchar_t* path, const wchar_t* mode)
+	{
+#if defined(PUGI_IMPL_MSVC_CRT_VERSION) && PUGI_IMPL_MSVC_CRT_VERSION >= 1400
+		FILE* file = 0;
+		return _wfopen_s(&file, path, mode) == 0 ? file : 0;
+#else
+		return _wfopen(path, mode);
+#endif
+	}
+#else
+	PUGI_IMPL_FN char* convert_path_heap(const wchar_t* str)
+	{
+		assert(str);
+
+		// first pass: get length in utf8 characters
+		size_t length = strlength_wide(str);
+		size_t size = as_utf8_begin(str, length);
+
+		// allocate resulting string
+		char* result = static_cast<char*>(xml_memory::allocate(size + 1));
+		if (!result) return 0;
+
+		// second pass: convert to utf8
+		as_utf8_end(result, size, str, length);
+
+		// zero-terminate
+		result[size] = 0;
+
+		return result;
+	}
+
+	PUGI_IMPL_FN FILE* open_file_wide(const wchar_t* path, const wchar_t* mode)
+	{
+		// there is no standard function to open wide paths, so our best bet is to try utf8 path
+		char* path_utf8 = convert_path_heap(path);
+		if (!path_utf8) return 0;
+
+		// convert mode to ASCII (we mirror _wfopen interface)
+		char mode_ascii[4] = {0};
+		for (size_t i = 0; mode[i]; ++i) mode_ascii[i] = static_cast<char>(mode[i]);
+
+		// try to open the utf8 path
+		FILE* result = fopen(path_utf8, mode_ascii);
+
+		// free dummy buffer
+		xml_memory::deallocate(path_utf8);
+
+		return result;
+	}
+#endif
+
+	PUGI_IMPL_FN FILE* open_file(const char* path, const char* mode)
+	{
+#if defined(PUGI_IMPL_MSVC_CRT_VERSION) && PUGI_IMPL_MSVC_CRT_VERSION >= 1400
+		FILE* file = 0;
+		return fopen_s(&file, path, mode) == 0 ? file : 0;
+#else
+		return fopen(path, mode);
+#endif
+	}
+
+	PUGI_IMPL_FN bool save_file_impl(const xml_document& doc, FILE* file, const char_t* indent, unsigned int flags, xml_encoding encoding)
+	{
+		if (!file) return false;
+
+		xml_writer_file writer(file);
+		doc.save(writer, indent, flags, encoding);
+
+		return fflush(file) == 0 && ferror(file) == 0;
+	}
+
+	struct name_null_sentry
+	{
+		xml_node_struct* node;
+		char_t* name;
+
+		name_null_sentry(xml_node_struct* node_): node(node_), name(node_->name)
+		{
+			node->name = 0;
+		}
+
+		~name_null_sentry()
+		{
+			node->name = name;
+		}
+	};
+PUGI_IMPL_NS_END
+
+namespace pugi
+{
+	PUGI_IMPL_FN xml_writer::~xml_writer()
+	{
+	}
+
+	PUGI_IMPL_FN xml_writer_file::xml_writer_file(void* file_): file(file_)
+	{
+	}
+
+	PUGI_IMPL_FN void xml_writer_file::write(const void* data, size_t size)
+	{
+		size_t result = fwrite(data, 1, size, static_cast<FILE*>(file));
+		(void)!result; // unfortunately we can't do proper error handling here
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN xml_writer_stream::xml_writer_stream(std::basic_ostream<char, std::char_traits<char> >& stream): narrow_stream(&stream), wide_stream(0)
+	{
+	}
+
+	PUGI_IMPL_FN xml_writer_stream::xml_writer_stream(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& stream): narrow_stream(0), wide_stream(&stream)
+	{
+	}
+
+	PUGI_IMPL_FN void xml_writer_stream::write(const void* data, size_t size)
+	{
+		if (narrow_stream)
+		{
+			assert(!wide_stream);
+			narrow_stream->write(reinterpret_cast<const char*>(data), static_cast<std::streamsize>(size));
+		}
+		else
+		{
+			assert(wide_stream);
+			assert(size % sizeof(wchar_t) == 0);
+
+			wide_stream->write(reinterpret_cast<const wchar_t*>(data), static_cast<std::streamsize>(size / sizeof(wchar_t)));
+		}
+	}
+#endif
+
+	PUGI_IMPL_FN xml_tree_walker::xml_tree_walker(): _depth(0)
+	{
+	}
+
+	PUGI_IMPL_FN xml_tree_walker::~xml_tree_walker()
+	{
+	}
+
+	PUGI_IMPL_FN int xml_tree_walker::depth() const
+	{
+		return _depth;
+	}
+
+	PUGI_IMPL_FN bool xml_tree_walker::begin(xml_node&)
+	{
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xml_tree_walker::end(xml_node&)
+	{
+		return true;
+	}
+
+	PUGI_IMPL_FN xml_attribute::xml_attribute(): _attr(0)
+	{
+	}
+
+	PUGI_IMPL_FN xml_attribute::xml_attribute(xml_attribute_struct* attr): _attr(attr)
+	{
+	}
+
+	PUGI_IMPL_FN static void unspecified_bool_xml_attribute(xml_attribute***)
+	{
+	}
+
+	PUGI_IMPL_FN xml_attribute::operator xml_attribute::unspecified_bool_type() const
+	{
+		return _attr ? unspecified_bool_xml_attribute : 0;
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator!() const
+	{
+		return !_attr;
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator==(const xml_attribute& r) const
+	{
+		return (_attr == r._attr);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator!=(const xml_attribute& r) const
+	{
+		return (_attr != r._attr);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator<(const xml_attribute& r) const
+	{
+		return (_attr < r._attr);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator>(const xml_attribute& r) const
+	{
+		return (_attr > r._attr);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator<=(const xml_attribute& r) const
+	{
+		return (_attr <= r._attr);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator>=(const xml_attribute& r) const
+	{
+		return (_attr >= r._attr);
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_attribute::next_attribute() const
+	{
+		if (!_attr) return xml_attribute();
+		return xml_attribute(_attr->next_attribute);
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_attribute::previous_attribute() const
+	{
+		if (!_attr) return xml_attribute();
+		xml_attribute_struct* prev = _attr->prev_attribute_c;
+		return prev->next_attribute ? xml_attribute(prev) : xml_attribute();
+	}
+
+	PUGI_IMPL_FN const char_t* xml_attribute::as_string(const char_t* def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? value : def;
+	}
+
+	PUGI_IMPL_FN int xml_attribute::as_int(int def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_int(value) : def;
+	}
+
+	PUGI_IMPL_FN unsigned int xml_attribute::as_uint(unsigned int def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_uint(value) : def;
+	}
+
+	PUGI_IMPL_FN double xml_attribute::as_double(double def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_double(value) : def;
+	}
+
+	PUGI_IMPL_FN float xml_attribute::as_float(float def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_float(value) : def;
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::as_bool(bool def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_bool(value) : def;
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN long long xml_attribute::as_llong(long long def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_llong(value) : def;
+	}
+
+	PUGI_IMPL_FN unsigned long long xml_attribute::as_ullong(unsigned long long def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_ullong(value) : def;
+	}
+#endif
+
+	PUGI_IMPL_FN bool xml_attribute::empty() const
+	{
+		return !_attr;
+	}
+
+	PUGI_IMPL_FN const char_t* xml_attribute::name() const
+	{
+		if (!_attr) return PUGIXML_TEXT("");
+		const char_t* name = _attr->name;
+		return name ? name : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const char_t* xml_attribute::value() const
+	{
+		if (!_attr) return PUGIXML_TEXT("");
+		const char_t* value = _attr->value;
+		return value ? value : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN size_t xml_attribute::hash_value() const
+	{
+		return static_cast<size_t>(reinterpret_cast<uintptr_t>(_attr) / sizeof(xml_attribute_struct));
+	}
+
+	PUGI_IMPL_FN xml_attribute_struct* xml_attribute::internal_object() const
+	{
+		return _attr;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(const char_t* rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(int rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(unsigned int rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(long rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(unsigned long rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(double rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(float rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(bool rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(long long rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(unsigned long long rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN bool xml_attribute::set_name(const char_t* rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::strcpy_insitu(_attr->name, _attr->header, impl::xml_memory_page_name_allocated_mask, rhs, impl::strlength(rhs));
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_name(const char_t* rhs, size_t size)
+	{
+		if (!_attr) return false;
+
+		return impl::strcpy_insitu(_attr->name, _attr->header, impl::xml_memory_page_name_allocated_mask, rhs, size);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(const char_t* rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::strcpy_insitu(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, impl::strlength(rhs));
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(const char_t* rhs, size_t size)
+	{
+		if (!_attr) return false;
+
+		return impl::strcpy_insitu(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, size);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(int rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned int>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(unsigned int rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned int>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, false);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(long rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned long>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(unsigned long rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned long>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, false);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(double rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_convert(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, default_double_precision);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(double rhs, int precision)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_convert(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, precision);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(float rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_convert(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, default_float_precision);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(float rhs, int precision)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_convert(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, precision);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(bool rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_bool(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs);
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN bool xml_attribute::set_value(long long rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned long long>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(unsigned long long rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned long long>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, false);
+	}
+#endif
+
+#ifdef __BORLANDC__
+	PUGI_IMPL_FN bool operator&&(const xml_attribute& lhs, bool rhs)
+	{
+		return (bool)lhs && rhs;
+	}
+
+	PUGI_IMPL_FN bool operator||(const xml_attribute& lhs, bool rhs)
+	{
+		return (bool)lhs || rhs;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_node::xml_node(): _root(0)
+	{
+	}
+
+	PUGI_IMPL_FN xml_node::xml_node(xml_node_struct* p): _root(p)
+	{
+	}
+
+	PUGI_IMPL_FN static void unspecified_bool_xml_node(xml_node***)
+	{
+	}
+
+	PUGI_IMPL_FN xml_node::operator xml_node::unspecified_bool_type() const
+	{
+		return _root ? unspecified_bool_xml_node : 0;
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator!() const
+	{
+		return !_root;
+	}
+
+	PUGI_IMPL_FN xml_node::iterator xml_node::begin() const
+	{
+		return iterator(_root ? _root->first_child + 0 : 0, _root);
+	}
+
+	PUGI_IMPL_FN xml_node::iterator xml_node::end() const
+	{
+		return iterator(0, _root);
+	}
+
+	PUGI_IMPL_FN xml_node::attribute_iterator xml_node::attributes_begin() const
+	{
+		return attribute_iterator(_root ? _root->first_attribute + 0 : 0, _root);
+	}
+
+	PUGI_IMPL_FN xml_node::attribute_iterator xml_node::attributes_end() const
+	{
+		return attribute_iterator(0, _root);
+	}
+
+	PUGI_IMPL_FN xml_object_range<xml_node_iterator> xml_node::children() const
+	{
+		return xml_object_range<xml_node_iterator>(begin(), end());
+	}
+
+	PUGI_IMPL_FN xml_object_range<xml_named_node_iterator> xml_node::children(const char_t* name_) const
+	{
+		return xml_object_range<xml_named_node_iterator>(xml_named_node_iterator(child(name_)._root, _root, name_), xml_named_node_iterator(0, _root, name_));
+	}
+
+	PUGI_IMPL_FN xml_object_range<xml_attribute_iterator> xml_node::attributes() const
+	{
+		return xml_object_range<xml_attribute_iterator>(attributes_begin(), attributes_end());
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator==(const xml_node& r) const
+	{
+		return (_root == r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator!=(const xml_node& r) const
+	{
+		return (_root != r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator<(const xml_node& r) const
+	{
+		return (_root < r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator>(const xml_node& r) const
+	{
+		return (_root > r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator<=(const xml_node& r) const
+	{
+		return (_root <= r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator>=(const xml_node& r) const
+	{
+		return (_root >= r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::empty() const
+	{
+		return !_root;
+	}
+
+	PUGI_IMPL_FN const char_t* xml_node::name() const
+	{
+		if (!_root) return PUGIXML_TEXT("");
+		const char_t* name = _root->name;
+		return name ? name : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN xml_node_type xml_node::type() const
+	{
+		return _root ? PUGI_IMPL_NODETYPE(_root) : node_null;
+	}
+
+	PUGI_IMPL_FN const char_t* xml_node::value() const
+	{
+		if (!_root) return PUGIXML_TEXT("");
+		const char_t* value = _root->value;
+		return value ? value : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::child(const char_t* name_) const
+	{
+		if (!_root) return xml_node();
+
+		for (xml_node_struct* i = _root->first_child; i; i = i->next_sibling)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+				return xml_node(i);
+		}
+
+		return xml_node();
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::attribute(const char_t* name_) const
+	{
+		if (!_root) return xml_attribute();
+
+		for (xml_attribute_struct* i = _root->first_attribute; i; i = i->next_attribute)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+				return xml_attribute(i);
+		}
+
+		return xml_attribute();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::next_sibling(const char_t* name_) const
+	{
+		if (!_root) return xml_node();
+
+		for (xml_node_struct* i = _root->next_sibling; i; i = i->next_sibling)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+				return xml_node(i);
+		}
+
+		return xml_node();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::next_sibling() const
+	{
+		return _root ? xml_node(_root->next_sibling) : xml_node();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::previous_sibling(const char_t* name_) const
+	{
+		if (!_root) return xml_node();
+
+		for (xml_node_struct* i = _root->prev_sibling_c; i->next_sibling; i = i->prev_sibling_c)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+				return xml_node(i);
+		}
+
+		return xml_node();
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::attribute(const char_t* name_, xml_attribute& hint_) const
+	{
+		xml_attribute_struct* hint = hint_._attr;
+
+		// if hint is not an attribute of node, behavior is not defined
+		assert(!hint || (_root && impl::is_attribute_of(hint, _root)));
+
+		if (!_root) return xml_attribute();
+
+		// optimistically search from hint up until the end
+		for (xml_attribute_struct* i = hint; i; i = i->next_attribute)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+			{
+				// update hint to maximize efficiency of searching for consecutive attributes
+				hint_._attr = i->next_attribute;
+
+				return xml_attribute(i);
+			}
+		}
+
+		// wrap around and search from the first attribute until the hint
+		// 'j' null pointer check is technically redundant, but it prevents a crash in case the assertion above fails
+		for (xml_attribute_struct* j = _root->first_attribute; j && j != hint; j = j->next_attribute)
+		{
+			const char_t* jname = j->name;
+			if (jname && impl::strequal(name_, jname))
+			{
+				// update hint to maximize efficiency of searching for consecutive attributes
+				hint_._attr = j->next_attribute;
+
+				return xml_attribute(j);
+			}
+		}
+
+		return xml_attribute();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::previous_sibling() const
+	{
+		if (!_root) return xml_node();
+		xml_node_struct* prev = _root->prev_sibling_c;
+		return prev->next_sibling ? xml_node(prev) : xml_node();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::parent() const
+	{
+		return _root ? xml_node(_root->parent) : xml_node();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::root() const
+	{
+		return _root ? xml_node(&impl::get_document(_root)) : xml_node();
+	}
+
+	PUGI_IMPL_FN xml_text xml_node::text() const
+	{
+		return xml_text(_root);
+	}
+
+	PUGI_IMPL_FN const char_t* xml_node::child_value() const
+	{
+		if (!_root) return PUGIXML_TEXT("");
+
+		// element nodes can have value if parse_embed_pcdata was used
+		if (PUGI_IMPL_NODETYPE(_root) == node_element && _root->value)
+			return _root->value;
+
+		for (xml_node_struct* i = _root->first_child; i; i = i->next_sibling)
+		{
+			const char_t* ivalue = i->value;
+			if (impl::is_text_node(i) && ivalue)
+				return ivalue;
+		}
+
+		return PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const char_t* xml_node::child_value(const char_t* name_) const
+	{
+		return child(name_).child_value();
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::first_attribute() const
+	{
+		if (!_root) return xml_attribute();
+		return xml_attribute(_root->first_attribute);
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::last_attribute() const
+	{
+		if (!_root) return xml_attribute();
+		xml_attribute_struct* first = _root->first_attribute;
+		return first ? xml_attribute(first->prev_attribute_c) : xml_attribute();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::first_child() const
+	{
+		if (!_root) return xml_node();
+		return xml_node(_root->first_child);
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::last_child() const
+	{
+		if (!_root) return xml_node();
+		xml_node_struct* first = _root->first_child;
+		return first ? xml_node(first->prev_sibling_c) : xml_node();
+	}
+
+	PUGI_IMPL_FN bool xml_node::set_name(const char_t* rhs)
+	{
+		xml_node_type type_ = _root ? PUGI_IMPL_NODETYPE(_root) : node_null;
+
+		if (type_ != node_element && type_ != node_pi && type_ != node_declaration)
+			return false;
+
+		return impl::strcpy_insitu(_root->name, _root->header, impl::xml_memory_page_name_allocated_mask, rhs, impl::strlength(rhs));
+	}
+
+	PUGI_IMPL_FN bool xml_node::set_name(const char_t* rhs, size_t size)
+	{
+		xml_node_type type_ = _root ? PUGI_IMPL_NODETYPE(_root) : node_null;
+
+		if (type_ != node_element && type_ != node_pi && type_ != node_declaration)
+			return false;
+
+		return impl::strcpy_insitu(_root->name, _root->header, impl::xml_memory_page_name_allocated_mask, rhs, size);
+	}
+
+	PUGI_IMPL_FN bool xml_node::set_value(const char_t* rhs)
+	{
+		xml_node_type type_ = _root ? PUGI_IMPL_NODETYPE(_root) : node_null;
+
+		if (type_ != node_pcdata && type_ != node_cdata && type_ != node_comment && type_ != node_pi && type_ != node_doctype)
+			return false;
+
+		return impl::strcpy_insitu(_root->value, _root->header, impl::xml_memory_page_value_allocated_mask, rhs, impl::strlength(rhs));
+	}
+
+	PUGI_IMPL_FN bool xml_node::set_value(const char_t* rhs, size_t size)
+	{
+		xml_node_type type_ = _root ? PUGI_IMPL_NODETYPE(_root) : node_null;
+
+		if (type_ != node_pcdata && type_ != node_cdata && type_ != node_comment && type_ != node_pi && type_ != node_doctype)
+			return false;
+
+		return impl::strcpy_insitu(_root->value, _root->header, impl::xml_memory_page_value_allocated_mask, rhs, size);
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::append_attribute(const char_t* name_)
+	{
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::append_attribute(a._attr, _root);
+
+		a.set_name(name_);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::prepend_attribute(const char_t* name_)
+	{
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::prepend_attribute(a._attr, _root);
+
+		a.set_name(name_);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::insert_attribute_after(const char_t* name_, const xml_attribute& attr)
+	{
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+		if (!attr || !impl::is_attribute_of(attr._attr, _root)) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::insert_attribute_after(a._attr, attr._attr, _root);
+
+		a.set_name(name_);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::insert_attribute_before(const char_t* name_, const xml_attribute& attr)
+	{
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+		if (!attr || !impl::is_attribute_of(attr._attr, _root)) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::insert_attribute_before(a._attr, attr._attr, _root);
+
+		a.set_name(name_);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::append_copy(const xml_attribute& proto)
+	{
+		if (!proto) return xml_attribute();
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::append_attribute(a._attr, _root);
+		impl::node_copy_attribute(a._attr, proto._attr);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::prepend_copy(const xml_attribute& proto)
+	{
+		if (!proto) return xml_attribute();
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::prepend_attribute(a._attr, _root);
+		impl::node_copy_attribute(a._attr, proto._attr);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::insert_copy_after(const xml_attribute& proto, const xml_attribute& attr)
+	{
+		if (!proto) return xml_attribute();
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+		if (!attr || !impl::is_attribute_of(attr._attr, _root)) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::insert_attribute_after(a._attr, attr._attr, _root);
+		impl::node_copy_attribute(a._attr, proto._attr);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::insert_copy_before(const xml_attribute& proto, const xml_attribute& attr)
+	{
+		if (!proto) return xml_attribute();
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+		if (!attr || !impl::is_attribute_of(attr._attr, _root)) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::insert_attribute_before(a._attr, attr._attr, _root);
+		impl::node_copy_attribute(a._attr, proto._attr);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::append_child(xml_node_type type_)
+	{
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::append_node(n._root, _root);
+
+		if (type_ == node_declaration) n.set_name(PUGIXML_TEXT("xml"));
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::prepend_child(xml_node_type type_)
+	{
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::prepend_node(n._root, _root);
+
+		if (type_ == node_declaration) n.set_name(PUGIXML_TEXT("xml"));
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_child_before(xml_node_type type_, const xml_node& node)
+	{
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::insert_node_before(n._root, node._root);
+
+		if (type_ == node_declaration) n.set_name(PUGIXML_TEXT("xml"));
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_child_after(xml_node_type type_, const xml_node& node)
+	{
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::insert_node_after(n._root, node._root);
+
+		if (type_ == node_declaration) n.set_name(PUGIXML_TEXT("xml"));
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::append_child(const char_t* name_)
+	{
+		xml_node result = append_child(node_element);
+
+		result.set_name(name_);
+
+		return result;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::prepend_child(const char_t* name_)
+	{
+		xml_node result = prepend_child(node_element);
+
+		result.set_name(name_);
+
+		return result;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_child_after(const char_t* name_, const xml_node& node)
+	{
+		xml_node result = insert_child_after(node_element, node);
+
+		result.set_name(name_);
+
+		return result;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_child_before(const char_t* name_, const xml_node& node)
+	{
+		xml_node result = insert_child_before(node_element, node);
+
+		result.set_name(name_);
+
+		return result;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::append_copy(const xml_node& proto)
+	{
+		xml_node_type type_ = proto.type();
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::append_node(n._root, _root);
+		impl::node_copy_tree(n._root, proto._root);
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::prepend_copy(const xml_node& proto)
+	{
+		xml_node_type type_ = proto.type();
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::prepend_node(n._root, _root);
+		impl::node_copy_tree(n._root, proto._root);
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_copy_after(const xml_node& proto, const xml_node& node)
+	{
+		xml_node_type type_ = proto.type();
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::insert_node_after(n._root, node._root);
+		impl::node_copy_tree(n._root, proto._root);
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_copy_before(const xml_node& proto, const xml_node& node)
+	{
+		xml_node_type type_ = proto.type();
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::insert_node_before(n._root, node._root);
+		impl::node_copy_tree(n._root, proto._root);
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::append_move(const xml_node& moved)
+	{
+		if (!impl::allow_move(*this, moved)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		// disable document_buffer_order optimization since moving nodes around changes document order without changing buffer pointers
+		impl::get_document(_root).header |= impl::xml_memory_page_contents_shared_mask;
+
+		impl::remove_node(moved._root);
+		impl::append_node(moved._root, _root);
+
+		return moved;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::prepend_move(const xml_node& moved)
+	{
+		if (!impl::allow_move(*this, moved)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		// disable document_buffer_order optimization since moving nodes around changes document order without changing buffer pointers
+		impl::get_document(_root).header |= impl::xml_memory_page_contents_shared_mask;
+
+		impl::remove_node(moved._root);
+		impl::prepend_node(moved._root, _root);
+
+		return moved;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_move_after(const xml_node& moved, const xml_node& node)
+	{
+		if (!impl::allow_move(*this, moved)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+		if (moved._root == node._root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		// disable document_buffer_order optimization since moving nodes around changes document order without changing buffer pointers
+		impl::get_document(_root).header |= impl::xml_memory_page_contents_shared_mask;
+
+		impl::remove_node(moved._root);
+		impl::insert_node_after(moved._root, node._root);
+
+		return moved;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_move_before(const xml_node& moved, const xml_node& node)
+	{
+		if (!impl::allow_move(*this, moved)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+		if (moved._root == node._root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		// disable document_buffer_order optimization since moving nodes around changes document order without changing buffer pointers
+		impl::get_document(_root).header |= impl::xml_memory_page_contents_shared_mask;
+
+		impl::remove_node(moved._root);
+		impl::insert_node_before(moved._root, node._root);
+
+		return moved;
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_attribute(const char_t* name_)
+	{
+		return remove_attribute(attribute(name_));
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_attribute(const xml_attribute& a)
+	{
+		if (!_root || !a._attr) return false;
+		if (!impl::is_attribute_of(a._attr, _root)) return false;
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return false;
+
+		impl::remove_attribute(a._attr, _root);
+		impl::destroy_attribute(a._attr, alloc);
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_attributes()
+	{
+		if (!_root) return false;
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return false;
+
+		for (xml_attribute_struct* attr = _root->first_attribute; attr; )
+		{
+			xml_attribute_struct* next = attr->next_attribute;
+
+			impl::destroy_attribute(attr, alloc);
+
+			attr = next;
+		}
+
+		_root->first_attribute = 0;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_child(const char_t* name_)
+	{
+		return remove_child(child(name_));
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_child(const xml_node& n)
+	{
+		if (!_root || !n._root || n._root->parent != _root) return false;
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return false;
+
+		impl::remove_node(n._root);
+		impl::destroy_node(n._root, alloc);
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_children()
+	{
+		if (!_root) return false;
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return false;
+
+		for (xml_node_struct* cur = _root->first_child; cur; )
+		{
+			xml_node_struct* next = cur->next_sibling;
+
+			impl::destroy_node(cur, alloc);
+
+			cur = next;
+		}
+
+		_root->first_child = 0;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_node::append_buffer(const void* contents, size_t size, unsigned int options, xml_encoding encoding)
+	{
+		// append_buffer is only valid for elements/documents
+		if (!impl::allow_insert_child(type(), node_element)) return impl::make_parse_result(status_append_invalid_root);
+
+		// append buffer can not merge PCDATA into existing PCDATA nodes
+		if ((options & parse_merge_pcdata) != 0 && last_child().type() == node_pcdata) return impl::make_parse_result(status_append_invalid_root);
+
+		// get document node
+		impl::xml_document_struct* doc = &impl::get_document(_root);
+
+		// disable document_buffer_order optimization since in a document with multiple buffers comparing buffer pointers does not make sense
+		doc->header |= impl::xml_memory_page_contents_shared_mask;
+
+		// get extra buffer element (we'll store the document fragment buffer there so that we can deallocate it later)
+		impl::xml_memory_page* page = 0;
+		impl::xml_extra_buffer* extra = static_cast<impl::xml_extra_buffer*>(doc->allocate_memory(sizeof(impl::xml_extra_buffer) + sizeof(void*), page));
+		(void)page;
+
+		if (!extra) return impl::make_parse_result(status_out_of_memory);
+
+	#ifdef PUGIXML_COMPACT
+		// align the memory block to a pointer boundary; this is required for compact mode where memory allocations are only 4b aligned
+		// note that this requires up to sizeof(void*)-1 additional memory, which the allocation above takes into account
+		extra = reinterpret_cast<impl::xml_extra_buffer*>((reinterpret_cast<uintptr_t>(extra) + (sizeof(void*) - 1)) & ~(sizeof(void*) - 1));
+	#endif
+
+		// add extra buffer to the list
+		extra->buffer = 0;
+		extra->next = doc->extra_buffers;
+		doc->extra_buffers = extra;
+
+		// name of the root has to be NULL before parsing - otherwise closing node mismatches will not be detected at the top level
+		impl::name_null_sentry sentry(_root);
+
+		return impl::load_buffer_impl(doc, _root, const_cast<void*>(contents), size, options, encoding, false, false, &extra->buffer);
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::find_child_by_attribute(const char_t* name_, const char_t* attr_name, const char_t* attr_value) const
+	{
+		if (!_root) return xml_node();
+
+		for (xml_node_struct* i = _root->first_child; i; i = i->next_sibling)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+			{
+				for (xml_attribute_struct* a = i->first_attribute; a; a = a->next_attribute)
+				{
+					const char_t* aname = a->name;
+					if (aname && impl::strequal(attr_name, aname))
+					{
+						const char_t* avalue = a->value;
+						if (impl::strequal(attr_value, avalue ? avalue : PUGIXML_TEXT("")))
+							return xml_node(i);
+					}
+				}
+			}
+		}
+
+		return xml_node();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::find_child_by_attribute(const char_t* attr_name, const char_t* attr_value) const
+	{
+		if (!_root) return xml_node();
+
+		for (xml_node_struct* i = _root->first_child; i; i = i->next_sibling)
+			for (xml_attribute_struct* a = i->first_attribute; a; a = a->next_attribute)
+			{
+				const char_t* aname = a->name;
+				if (aname && impl::strequal(attr_name, aname))
+				{
+					const char_t* avalue = a->value;
+					if (impl::strequal(attr_value, avalue ? avalue : PUGIXML_TEXT("")))
+						return xml_node(i);
+				}
+			}
+
+		return xml_node();
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN string_t xml_node::path(char_t delimiter) const
+	{
+		if (!_root) return string_t();
+
+		size_t offset = 0;
+
+		for (xml_node_struct* i = _root; i; i = i->parent)
+		{
+			const char_t* iname = i->name;
+			offset += (i != _root);
+			offset += iname ? impl::strlength(iname) : 0;
+		}
+
+		string_t result;
+		result.resize(offset);
+
+		for (xml_node_struct* j = _root; j; j = j->parent)
+		{
+			if (j != _root)
+				result[--offset] = delimiter;
+
+			const char_t* jname = j->name;
+			if (jname)
+			{
+				size_t length = impl::strlength(jname);
+
+				offset -= length;
+				memcpy(&result[offset], jname, length * sizeof(char_t));
+			}
+		}
+
+		assert(offset == 0);
+
+		return result;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_node xml_node::first_element_by_path(const char_t* path_, char_t delimiter) const
+	{
+		xml_node context = path_[0] == delimiter ? root() : *this;
+
+		if (!context._root) return xml_node();
+
+		const char_t* path_segment = path_;
+
+		while (*path_segment == delimiter) ++path_segment;
+
+		const char_t* path_segment_end = path_segment;
+
+		while (*path_segment_end && *path_segment_end != delimiter) ++path_segment_end;
+
+		if (path_segment == path_segment_end) return context;
+
+		const char_t* next_segment = path_segment_end;
+
+		while (*next_segment == delimiter) ++next_segment;
+
+		if (*path_segment == '.' && path_segment + 1 == path_segment_end)
+			return context.first_element_by_path(next_segment, delimiter);
+		else if (*path_segment == '.' && *(path_segment+1) == '.' && path_segment + 2 == path_segment_end)
+			return context.parent().first_element_by_path(next_segment, delimiter);
+		else
+		{
+			for (xml_node_struct* j = context._root->first_child; j; j = j->next_sibling)
+			{
+				const char_t* jname = j->name;
+				if (jname && impl::strequalrange(jname, path_segment, static_cast<size_t>(path_segment_end - path_segment)))
+				{
+					xml_node subsearch = xml_node(j).first_element_by_path(next_segment, delimiter);
+
+					if (subsearch) return subsearch;
+				}
+			}
+
+			return xml_node();
+		}
+	}
+
+	PUGI_IMPL_FN bool xml_node::traverse(xml_tree_walker& walker)
+	{
+		walker._depth = -1;
+
+		xml_node arg_begin(_root);
+		if (!walker.begin(arg_begin)) return false;
+
+		xml_node_struct* cur = _root ? _root->first_child + 0 : 0;
+
+		if (cur)
+		{
+			++walker._depth;
+
+			do
+			{
+				xml_node arg_for_each(cur);
+				if (!walker.for_each(arg_for_each))
+					return false;
+
+				if (cur->first_child)
+				{
+					++walker._depth;
+					cur = cur->first_child;
+				}
+				else if (cur->next_sibling)
+					cur = cur->next_sibling;
+				else
+				{
+					while (!cur->next_sibling && cur != _root && cur->parent)
+					{
+						--walker._depth;
+						cur = cur->parent;
+					}
+
+					if (cur != _root)
+						cur = cur->next_sibling;
+				}
+			}
+			while (cur && cur != _root);
+		}
+
+		assert(walker._depth == -1);
+
+		xml_node arg_end(_root);
+		return walker.end(arg_end);
+	}
+
+	PUGI_IMPL_FN size_t xml_node::hash_value() const
+	{
+		return static_cast<size_t>(reinterpret_cast<uintptr_t>(_root) / sizeof(xml_node_struct));
+	}
+
+	PUGI_IMPL_FN xml_node_struct* xml_node::internal_object() const
+	{
+		return _root;
+	}
+
+	PUGI_IMPL_FN void xml_node::print(xml_writer& writer, const char_t* indent, unsigned int flags, xml_encoding encoding, unsigned int depth) const
+	{
+		if (!_root) return;
+
+		impl::xml_buffered_writer buffered_writer(writer, encoding);
+
+		impl::node_output(buffered_writer, _root, indent, flags, depth);
+
+		buffered_writer.flush();
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN void xml_node::print(std::basic_ostream<char, std::char_traits<char> >& stream, const char_t* indent, unsigned int flags, xml_encoding encoding, unsigned int depth) const
+	{
+		xml_writer_stream writer(stream);
+
+		print(writer, indent, flags, encoding, depth);
+	}
+
+	PUGI_IMPL_FN void xml_node::print(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& stream, const char_t* indent, unsigned int flags, unsigned int depth) const
+	{
+		xml_writer_stream writer(stream);
+
+		print(writer, indent, flags, encoding_wchar, depth);
+	}
+#endif
+
+	PUGI_IMPL_FN ptrdiff_t xml_node::offset_debug() const
+	{
+		if (!_root) return -1;
+
+		impl::xml_document_struct& doc = impl::get_document(_root);
+
+		// we can determine the offset reliably only if there is exactly once parse buffer
+		if (!doc.buffer || doc.extra_buffers) return -1;
+
+		switch (type())
+		{
+		case node_document:
+			return 0;
+
+		case node_element:
+		case node_declaration:
+		case node_pi:
+			return _root->name && (_root->header & impl::xml_memory_page_name_allocated_or_shared_mask) == 0 ? _root->name - doc.buffer : -1;
+
+		case node_pcdata:
+		case node_cdata:
+		case node_comment:
+		case node_doctype:
+			return _root->value && (_root->header & impl::xml_memory_page_value_allocated_or_shared_mask) == 0 ? _root->value - doc.buffer : -1;
+
+		default:
+			assert(false && "Invalid node type"); // unreachable
+			return -1;
+		}
+	}
+
+#ifdef __BORLANDC__
+	PUGI_IMPL_FN bool operator&&(const xml_node& lhs, bool rhs)
+	{
+		return (bool)lhs && rhs;
+	}
+
+	PUGI_IMPL_FN bool operator||(const xml_node& lhs, bool rhs)
+	{
+		return (bool)lhs || rhs;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_text::xml_text(xml_node_struct* root): _root(root)
+	{
+	}
+
+	PUGI_IMPL_FN xml_node_struct* xml_text::_data() const
+	{
+		if (!_root || impl::is_text_node(_root)) return _root;
+
+		// element nodes can have value if parse_embed_pcdata was used
+		if (PUGI_IMPL_NODETYPE(_root) == node_element && _root->value)
+			return _root;
+
+		for (xml_node_struct* node = _root->first_child; node; node = node->next_sibling)
+			if (impl::is_text_node(node))
+				return node;
+
+		return 0;
+	}
+
+	PUGI_IMPL_FN xml_node_struct* xml_text::_data_new()
+	{
+		xml_node_struct* d = _data();
+		if (d) return d;
+
+		return xml_node(_root).append_child(node_pcdata).internal_object();
+	}
+
+	PUGI_IMPL_FN xml_text::xml_text(): _root(0)
+	{
+	}
+
+	PUGI_IMPL_FN static void unspecified_bool_xml_text(xml_text***)
+	{
+	}
+
+	PUGI_IMPL_FN xml_text::operator xml_text::unspecified_bool_type() const
+	{
+		return _data() ? unspecified_bool_xml_text : 0;
+	}
+
+	PUGI_IMPL_FN bool xml_text::operator!() const
+	{
+		return !_data();
+	}
+
+	PUGI_IMPL_FN bool xml_text::empty() const
+	{
+		return _data() == 0;
+	}
+
+	PUGI_IMPL_FN const char_t* xml_text::get() const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return PUGIXML_TEXT("");
+		const char_t* value = d->value;
+		return value ? value : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const char_t* xml_text::as_string(const char_t* def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? value : def;
+	}
+
+	PUGI_IMPL_FN int xml_text::as_int(int def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_int(value) : def;
+	}
+
+	PUGI_IMPL_FN unsigned int xml_text::as_uint(unsigned int def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_uint(value) : def;
+	}
+
+	PUGI_IMPL_FN double xml_text::as_double(double def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_double(value) : def;
+	}
+
+	PUGI_IMPL_FN float xml_text::as_float(float def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_float(value) : def;
+	}
+
+	PUGI_IMPL_FN bool xml_text::as_bool(bool def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_bool(value) : def;
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN long long xml_text::as_llong(long long def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_llong(value) : def;
+	}
+
+	PUGI_IMPL_FN unsigned long long xml_text::as_ullong(unsigned long long def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_ullong(value) : def;
+	}
+#endif
+
+	PUGI_IMPL_FN bool xml_text::set(const char_t* rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::strcpy_insitu(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, impl::strlength(rhs)) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(const char_t* rhs, size_t size)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::strcpy_insitu(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, size) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(int rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned int>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(unsigned int rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned int>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, false) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(long rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned long>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(unsigned long rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned long>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, false) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(float rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_convert(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, default_float_precision) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(float rhs, int precision)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_convert(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, precision) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(double rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_convert(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, default_double_precision) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(double rhs, int precision)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_convert(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, precision) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(bool rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_bool(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs) : false;
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN bool xml_text::set(long long rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned long long>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(unsigned long long rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned long long>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, false) : false;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(const char_t* rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(int rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(unsigned int rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(long rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(unsigned long rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(double rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(float rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(bool rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN xml_text& xml_text::operator=(long long rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(unsigned long long rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_node xml_text::data() const
+	{
+		return xml_node(_data());
+	}
+
+#ifdef __BORLANDC__
+	PUGI_IMPL_FN bool operator&&(const xml_text& lhs, bool rhs)
+	{
+		return (bool)lhs && rhs;
+	}
+
+	PUGI_IMPL_FN bool operator||(const xml_text& lhs, bool rhs)
+	{
+		return (bool)lhs || rhs;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_node_iterator::xml_node_iterator()
+	{
+	}
+
+	PUGI_IMPL_FN xml_node_iterator::xml_node_iterator(const xml_node& node): _wrap(node), _parent(node.parent())
+	{
+	}
+
+	PUGI_IMPL_FN xml_node_iterator::xml_node_iterator(xml_node_struct* ref, xml_node_struct* parent): _wrap(ref), _parent(parent)
+	{
+	}
+
+	PUGI_IMPL_FN bool xml_node_iterator::operator==(const xml_node_iterator& rhs) const
+	{
+		return _wrap._root == rhs._wrap._root && _parent._root == rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN bool xml_node_iterator::operator!=(const xml_node_iterator& rhs) const
+	{
+		return _wrap._root != rhs._wrap._root || _parent._root != rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN xml_node& xml_node_iterator::operator*() const
+	{
+		assert(_wrap._root);
+		return _wrap;
+	}
+
+	PUGI_IMPL_FN xml_node* xml_node_iterator::operator->() const
+	{
+		assert(_wrap._root);
+		return const_cast<xml_node*>(&_wrap); // BCC5 workaround
+	}
+
+	PUGI_IMPL_FN xml_node_iterator& xml_node_iterator::operator++()
+	{
+		assert(_wrap._root);
+		_wrap._root = _wrap._root->next_sibling;
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_node_iterator xml_node_iterator::operator++(int)
+	{
+		xml_node_iterator temp = *this;
+		++*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_node_iterator& xml_node_iterator::operator--()
+	{
+		_wrap = _wrap._root ? _wrap.previous_sibling() : _parent.last_child();
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_node_iterator xml_node_iterator::operator--(int)
+	{
+		xml_node_iterator temp = *this;
+		--*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator::xml_attribute_iterator()
+	{
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator::xml_attribute_iterator(const xml_attribute& attr, const xml_node& parent): _wrap(attr), _parent(parent)
+	{
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator::xml_attribute_iterator(xml_attribute_struct* ref, xml_node_struct* parent): _wrap(ref), _parent(parent)
+	{
+	}
+
+	PUGI_IMPL_FN bool xml_attribute_iterator::operator==(const xml_attribute_iterator& rhs) const
+	{
+		return _wrap._attr == rhs._wrap._attr && _parent._root == rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN bool xml_attribute_iterator::operator!=(const xml_attribute_iterator& rhs) const
+	{
+		return _wrap._attr != rhs._wrap._attr || _parent._root != rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute_iterator::operator*() const
+	{
+		assert(_wrap._attr);
+		return _wrap;
+	}
+
+	PUGI_IMPL_FN xml_attribute* xml_attribute_iterator::operator->() const
+	{
+		assert(_wrap._attr);
+		return const_cast<xml_attribute*>(&_wrap); // BCC5 workaround
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator& xml_attribute_iterator::operator++()
+	{
+		assert(_wrap._attr);
+		_wrap._attr = _wrap._attr->next_attribute;
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator xml_attribute_iterator::operator++(int)
+	{
+		xml_attribute_iterator temp = *this;
+		++*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator& xml_attribute_iterator::operator--()
+	{
+		_wrap = _wrap._attr ? _wrap.previous_attribute() : _parent.last_attribute();
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator xml_attribute_iterator::operator--(int)
+	{
+		xml_attribute_iterator temp = *this;
+		--*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator::xml_named_node_iterator(): _name(0)
+	{
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator::xml_named_node_iterator(const xml_node& node, const char_t* name): _wrap(node), _parent(node.parent()), _name(name)
+	{
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator::xml_named_node_iterator(xml_node_struct* ref, xml_node_struct* parent, const char_t* name): _wrap(ref), _parent(parent), _name(name)
+	{
+	}
+
+	PUGI_IMPL_FN bool xml_named_node_iterator::operator==(const xml_named_node_iterator& rhs) const
+	{
+		return _wrap._root == rhs._wrap._root && _parent._root == rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN bool xml_named_node_iterator::operator!=(const xml_named_node_iterator& rhs) const
+	{
+		return _wrap._root != rhs._wrap._root || _parent._root != rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN xml_node& xml_named_node_iterator::operator*() const
+	{
+		assert(_wrap._root);
+		return _wrap;
+	}
+
+	PUGI_IMPL_FN xml_node* xml_named_node_iterator::operator->() const
+	{
+		assert(_wrap._root);
+		return const_cast<xml_node*>(&_wrap); // BCC5 workaround
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator& xml_named_node_iterator::operator++()
+	{
+		assert(_wrap._root);
+		_wrap = _wrap.next_sibling(_name);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator xml_named_node_iterator::operator++(int)
+	{
+		xml_named_node_iterator temp = *this;
+		++*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator& xml_named_node_iterator::operator--()
+	{
+		if (_wrap._root)
+			_wrap = _wrap.previous_sibling(_name);
+		else
+		{
+			_wrap = _parent.last_child();
+
+			if (!impl::strequal(_wrap.name(), _name))
+				_wrap = _wrap.previous_sibling(_name);
+		}
+
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator xml_named_node_iterator::operator--(int)
+	{
+		xml_named_node_iterator temp = *this;
+		--*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_parse_result::xml_parse_result(): status(status_internal_error), offset(0), encoding(encoding_auto)
+	{
+	}
+
+	PUGI_IMPL_FN xml_parse_result::operator bool() const
+	{
+		return status == status_ok;
+	}
+
+	PUGI_IMPL_FN const char* xml_parse_result::description() const
+	{
+		switch (status)
+		{
+		case status_ok: return "No error";
+
+		case status_file_not_found: return "File was not found";
+		case status_io_error: return "Error reading from file/stream";
+		case status_out_of_memory: return "Could not allocate memory";
+		case status_internal_error: return "Internal error occurred";
+
+		case status_unrecognized_tag: return "Could not determine tag type";
+
+		case status_bad_pi: return "Error parsing document declaration/processing instruction";
+		case status_bad_comment: return "Error parsing comment";
+		case status_bad_cdata: return "Error parsing CDATA section";
+		case status_bad_doctype: return "Error parsing document type declaration";
+		case status_bad_pcdata: return "Error parsing PCDATA section";
+		case status_bad_start_element: return "Error parsing start element tag";
+		case status_bad_attribute: return "Error parsing element attribute";
+		case status_bad_end_element: return "Error parsing end element tag";
+		case status_end_element_mismatch: return "Start-end tags mismatch";
+
+		case status_append_invalid_root: return "Unable to append nodes: root is not an element or document";
+
+		case status_no_document_element: return "No document element found";
+
+		default: return "Unknown error";
+		}
+	}
+
+	PUGI_IMPL_FN xml_document::xml_document(): _buffer(0)
+	{
+		_create();
+	}
+
+	PUGI_IMPL_FN xml_document::~xml_document()
+	{
+		_destroy();
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN xml_document::xml_document(xml_document&& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT: _buffer(0)
+	{
+		_create();
+		_move(rhs);
+	}
+
+	PUGI_IMPL_FN xml_document& xml_document::operator=(xml_document&& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT
+	{
+		if (this == &rhs) return *this;
+
+		_destroy();
+		_create();
+		_move(rhs);
+
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN void xml_document::reset()
+	{
+		_destroy();
+		_create();
+	}
+
+	PUGI_IMPL_FN void xml_document::reset(const xml_document& proto)
+	{
+		reset();
+
+		impl::node_copy_tree(_root, proto._root);
+	}
+
+	PUGI_IMPL_FN void xml_document::_create()
+	{
+		assert(!_root);
+
+	#ifdef PUGIXML_COMPACT
+		// space for page marker for the first page (uint32_t), rounded up to pointer size; assumes pointers are at least 32-bit
+		const size_t page_offset = sizeof(void*);
+	#else
+		const size_t page_offset = 0;
+	#endif
+
+		// initialize sentinel page
+		PUGI_IMPL_STATIC_ASSERT(sizeof(impl::xml_memory_page) + sizeof(impl::xml_document_struct) + page_offset <= sizeof(_memory));
+
+		// prepare page structure
+		impl::xml_memory_page* page = impl::xml_memory_page::construct(_memory);
+		assert(page);
+
+		page->busy_size = impl::xml_memory_page_size;
+
+		// setup first page marker
+	#ifdef PUGIXML_COMPACT
+		// round-trip through void* to avoid 'cast increases required alignment of target type' warning
+		page->compact_page_marker = reinterpret_cast<uint32_t*>(static_cast<void*>(reinterpret_cast<char*>(page) + sizeof(impl::xml_memory_page)));
+		*page->compact_page_marker = sizeof(impl::xml_memory_page);
+	#endif
+
+		// allocate new root
+		_root = new (reinterpret_cast<char*>(page) + sizeof(impl::xml_memory_page) + page_offset) impl::xml_document_struct(page);
+		_root->prev_sibling_c = _root;
+
+		// setup sentinel page
+		page->allocator = static_cast<impl::xml_document_struct*>(_root);
+
+		// setup hash table pointer in allocator
+	#ifdef PUGIXML_COMPACT
+		page->allocator->_hash = &static_cast<impl::xml_document_struct*>(_root)->hash;
+	#endif
+
+		// verify the document allocation
+		assert(reinterpret_cast<char*>(_root) + sizeof(impl::xml_document_struct) <= _memory + sizeof(_memory));
+	}
+
+	PUGI_IMPL_FN void xml_document::_destroy()
+	{
+		assert(_root);
+
+		// destroy static storage
+		if (_buffer)
+		{
+			impl::xml_memory::deallocate(_buffer);
+			_buffer = 0;
+		}
+
+		// destroy extra buffers (note: no need to destroy linked list nodes, they're allocated using document allocator)
+		for (impl::xml_extra_buffer* extra = static_cast<impl::xml_document_struct*>(_root)->extra_buffers; extra; extra = extra->next)
+		{
+			if (extra->buffer) impl::xml_memory::deallocate(extra->buffer);
+		}
+
+		// destroy dynamic storage, leave sentinel page (it's in static memory)
+		impl::xml_memory_page* root_page = PUGI_IMPL_GETPAGE(_root);
+		assert(root_page && !root_page->prev);
+		assert(reinterpret_cast<char*>(root_page) >= _memory && reinterpret_cast<char*>(root_page) < _memory + sizeof(_memory));
+
+		for (impl::xml_memory_page* page = root_page->next; page; )
+		{
+			impl::xml_memory_page* next = page->next;
+
+			impl::xml_allocator::deallocate_page(page);
+
+			page = next;
+		}
+
+	#ifdef PUGIXML_COMPACT
+		// destroy hash table
+		static_cast<impl::xml_document_struct*>(_root)->hash.clear();
+	#endif
+
+		_root = 0;
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN void xml_document::_move(xml_document& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT
+	{
+		impl::xml_document_struct* doc = static_cast<impl::xml_document_struct*>(_root);
+		impl::xml_document_struct* other = static_cast<impl::xml_document_struct*>(rhs._root);
+
+		// save first child pointer for later; this needs hash access
+		xml_node_struct* other_first_child = other->first_child;
+
+	#ifdef PUGIXML_COMPACT
+		// reserve space for the hash table up front; this is the only operation that can fail
+		// if it does, we have no choice but to throw (if we have exceptions)
+		if (other_first_child)
+		{
+			size_t other_children = 0;
+			for (xml_node_struct* node = other_first_child; node; node = node->next_sibling)
+				other_children++;
+
+			// in compact mode, each pointer assignment could result in a hash table request
+			// during move, we have to relocate document first_child and parents of all children
+			// normally there's just one child and its parent has a pointerless encoding but
+			// we assume the worst here
+			if (!other->_hash->reserve(other_children + 1))
+			{
+			#ifdef PUGIXML_NO_EXCEPTIONS
+				return;
+			#else
+				throw std::bad_alloc();
+			#endif
+			}
+		}
+	#endif
+
+		// move allocation state
+		// note that other->_root may point to the embedded document page, in which case we should keep original (empty) state
+		if (other->_root != PUGI_IMPL_GETPAGE(other))
+		{
+			doc->_root = other->_root;
+			doc->_busy_size = other->_busy_size;
+		}
+
+		// move buffer state
+		doc->buffer = other->buffer;
+		doc->extra_buffers = other->extra_buffers;
+		_buffer = rhs._buffer;
+
+	#ifdef PUGIXML_COMPACT
+		// move compact hash; note that the hash table can have pointers to other but they will be "inactive", similarly to nodes removed with remove_child
+		doc->hash = other->hash;
+		doc->_hash = &doc->hash;
+
+		// make sure we don't access other hash up until the end when we reinitialize other document
+		other->_hash = 0;
+	#endif
+
+		// move page structure
+		impl::xml_memory_page* doc_page = PUGI_IMPL_GETPAGE(doc);
+		assert(doc_page && !doc_page->prev && !doc_page->next);
+
+		impl::xml_memory_page* other_page = PUGI_IMPL_GETPAGE(other);
+		assert(other_page && !other_page->prev);
+
+		// relink pages since root page is embedded into xml_document
+		if (impl::xml_memory_page* page = other_page->next)
+		{
+			assert(page->prev == other_page);
+
+			page->prev = doc_page;
+
+			doc_page->next = page;
+			other_page->next = 0;
+		}
+
+		// make sure pages point to the correct document state
+		for (impl::xml_memory_page* page = doc_page->next; page; page = page->next)
+		{
+			assert(page->allocator == other);
+
+			page->allocator = doc;
+
+		#ifdef PUGIXML_COMPACT
+			// this automatically migrates most children between documents and prevents ->parent assignment from allocating
+			if (page->compact_shared_parent == other)
+				page->compact_shared_parent = doc;
+		#endif
+		}
+
+		// move tree structure
+		assert(!doc->first_child);
+
+		doc->first_child = other_first_child;
+
+		for (xml_node_struct* node = other_first_child; node; node = node->next_sibling)
+		{
+		#ifdef PUGIXML_COMPACT
+			// most children will have migrated when we reassigned compact_shared_parent
+			assert(node->parent == other || node->parent == doc);
+
+			node->parent = doc;
+		#else
+			assert(node->parent == other);
+			node->parent = doc;
+		#endif
+		}
+
+		// reset other document
+		new (other) impl::xml_document_struct(PUGI_IMPL_GETPAGE(other));
+		rhs._buffer = 0;
+	}
+#endif
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN xml_parse_result xml_document::load(std::basic_istream<char, std::char_traits<char> >& stream, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		return impl::load_stream_impl(static_cast<impl::xml_document_struct*>(_root), stream, options, encoding, &_buffer);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load(std::basic_istream<wchar_t, std::char_traits<wchar_t> >& stream, unsigned int options)
+	{
+		reset();
+
+		return impl::load_stream_impl(static_cast<impl::xml_document_struct*>(_root), stream, options, encoding_wchar, &_buffer);
+	}
+#endif
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_string(const char_t* contents, unsigned int options)
+	{
+		// Force native encoding (skip autodetection)
+	#ifdef PUGIXML_WCHAR_MODE
+		xml_encoding encoding = encoding_wchar;
+	#else
+		xml_encoding encoding = encoding_utf8;
+	#endif
+
+		return load_buffer(contents, impl::strlength(contents) * sizeof(char_t), options, encoding);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load(const char_t* contents, unsigned int options)
+	{
+		return load_string(contents, options);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_file(const char* path_, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		using impl::auto_deleter; // MSVC7 workaround
+		auto_deleter<FILE> file(impl::open_file(path_, "rb"), impl::close_file);
+
+		return impl::load_file_impl(static_cast<impl::xml_document_struct*>(_root), file.data, options, encoding, &_buffer);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_file(const wchar_t* path_, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		using impl::auto_deleter; // MSVC7 workaround
+		auto_deleter<FILE> file(impl::open_file_wide(path_, L"rb"), impl::close_file);
+
+		return impl::load_file_impl(static_cast<impl::xml_document_struct*>(_root), file.data, options, encoding, &_buffer);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_buffer(const void* contents, size_t size, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		return impl::load_buffer_impl(static_cast<impl::xml_document_struct*>(_root), _root, const_cast<void*>(contents), size, options, encoding, false, false, &_buffer);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_buffer_inplace(void* contents, size_t size, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		return impl::load_buffer_impl(static_cast<impl::xml_document_struct*>(_root), _root, contents, size, options, encoding, true, false, &_buffer);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_buffer_inplace_own(void* contents, size_t size, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		return impl::load_buffer_impl(static_cast<impl::xml_document_struct*>(_root), _root, contents, size, options, encoding, true, true, &_buffer);
+	}
+
+	PUGI_IMPL_FN void xml_document::save(xml_writer& writer, const char_t* indent, unsigned int flags, xml_encoding encoding) const
+	{
+		impl::xml_buffered_writer buffered_writer(writer, encoding);
+
+		if ((flags & format_write_bom) && encoding != encoding_latin1)
+		{
+			// BOM always represents the codepoint U+FEFF, so just write it in native encoding
+		#ifdef PUGIXML_WCHAR_MODE
+			unsigned int bom = 0xfeff;
+			buffered_writer.write(static_cast<wchar_t>(bom));
+		#else
+			buffered_writer.write('\xef', '\xbb', '\xbf');
+		#endif
+		}
+
+		if (!(flags & format_no_declaration) && !impl::has_declaration(_root))
+		{
+			buffered_writer.write_string(PUGIXML_TEXT("<?xml version=\"1.0\""));
+			if (encoding == encoding_latin1) buffered_writer.write_string(PUGIXML_TEXT(" encoding=\"ISO-8859-1\""));
+			buffered_writer.write('?', '>');
+			if (!(flags & format_raw)) buffered_writer.write('\n');
+		}
+
+		impl::node_output(buffered_writer, _root, indent, flags, 0);
+
+		buffered_writer.flush();
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN void xml_document::save(std::basic_ostream<char, std::char_traits<char> >& stream, const char_t* indent, unsigned int flags, xml_encoding encoding) const
+	{
+		xml_writer_stream writer(stream);
+
+		save(writer, indent, flags, encoding);
+	}
+
+	PUGI_IMPL_FN void xml_document::save(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& stream, const char_t* indent, unsigned int flags) const
+	{
+		xml_writer_stream writer(stream);
+
+		save(writer, indent, flags, encoding_wchar);
+	}
+#endif
+
+	PUGI_IMPL_FN bool xml_document::save_file(const char* path_, const char_t* indent, unsigned int flags, xml_encoding encoding) const
+	{
+		using impl::auto_deleter; // MSVC7 workaround
+		auto_deleter<FILE> file(impl::open_file(path_, (flags & format_save_file_text) ? "w" : "wb"), impl::close_file);
+
+		return impl::save_file_impl(*this, file.data, indent, flags, encoding) && fclose(file.release()) == 0;
+	}
+
+	PUGI_IMPL_FN bool xml_document::save_file(const wchar_t* path_, const char_t* indent, unsigned int flags, xml_encoding encoding) const
+	{
+		using impl::auto_deleter; // MSVC7 workaround
+		auto_deleter<FILE> file(impl::open_file_wide(path_, (flags & format_save_file_text) ? L"w" : L"wb"), impl::close_file);
+
+		return impl::save_file_impl(*this, file.data, indent, flags, encoding) && fclose(file.release()) == 0;
+	}
+
+	PUGI_IMPL_FN xml_node xml_document::document_element() const
+	{
+		assert(_root);
+
+		for (xml_node_struct* i = _root->first_child; i; i = i->next_sibling)
+			if (PUGI_IMPL_NODETYPE(i) == node_element)
+				return xml_node(i);
+
+		return xml_node();
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN std::string PUGIXML_FUNCTION as_utf8(const wchar_t* str)
+	{
+		assert(str);
+
+		return impl::as_utf8_impl(str, impl::strlength_wide(str));
+	}
+
+	PUGI_IMPL_FN std::string PUGIXML_FUNCTION as_utf8(const std::basic_string<wchar_t>& str)
+	{
+		return impl::as_utf8_impl(str.c_str(), str.size());
+	}
+
+	PUGI_IMPL_FN std::basic_string<wchar_t> PUGIXML_FUNCTION as_wide(const char* str)
+	{
+		assert(str);
+
+		return impl::as_wide_impl(str, strlen(str));
+	}
+
+	PUGI_IMPL_FN std::basic_string<wchar_t> PUGIXML_FUNCTION as_wide(const std::string& str)
+	{
+		return impl::as_wide_impl(str.c_str(), str.size());
+	}
+#endif
+
+	PUGI_IMPL_FN void PUGIXML_FUNCTION set_memory_management_functions(allocation_function allocate, deallocation_function deallocate)
+	{
+		impl::xml_memory::allocate = allocate;
+		impl::xml_memory::deallocate = deallocate;
+	}
+
+	PUGI_IMPL_FN allocation_function PUGIXML_FUNCTION get_memory_allocation_function()
+	{
+		return impl::xml_memory::allocate;
+	}
+
+	PUGI_IMPL_FN deallocation_function PUGIXML_FUNCTION get_memory_deallocation_function()
+	{
+		return impl::xml_memory::deallocate;
+	}
+}
+
+#if !defined(PUGIXML_NO_STL) && (defined(_MSC_VER) || defined(__ICC))
+namespace std
+{
+	// Workarounds for (non-standard) iterator category detection for older versions (MSVC7/IC8 and earlier)
+	PUGI_IMPL_FN std::bidirectional_iterator_tag _Iter_cat(const pugi::xml_node_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+
+	PUGI_IMPL_FN std::bidirectional_iterator_tag _Iter_cat(const pugi::xml_attribute_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+
+	PUGI_IMPL_FN std::bidirectional_iterator_tag _Iter_cat(const pugi::xml_named_node_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+}
+#endif
+
+#if !defined(PUGIXML_NO_STL) && defined(__SUNPRO_CC)
+namespace std
+{
+	// Workarounds for (non-standard) iterator category detection
+	PUGI_IMPL_FN std::bidirectional_iterator_tag __iterator_category(const pugi::xml_node_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+
+	PUGI_IMPL_FN std::bidirectional_iterator_tag __iterator_category(const pugi::xml_attribute_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+
+	PUGI_IMPL_FN std::bidirectional_iterator_tag __iterator_category(const pugi::xml_named_node_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+}
+#endif
+
+#ifndef PUGIXML_NO_XPATH
+// STL replacements
+PUGI_IMPL_NS_BEGIN
+	struct equal_to
+	{
+		template <typename T> bool operator()(const T& lhs, const T& rhs) const
+		{
+			return lhs == rhs;
+		}
+	};
+
+	struct not_equal_to
+	{
+		template <typename T> bool operator()(const T& lhs, const T& rhs) const
+		{
+			return lhs != rhs;
+		}
+	};
+
+	struct less
+	{
+		template <typename T> bool operator()(const T& lhs, const T& rhs) const
+		{
+			return lhs < rhs;
+		}
+	};
+
+	struct less_equal
+	{
+		template <typename T> bool operator()(const T& lhs, const T& rhs) const
+		{
+			return lhs <= rhs;
+		}
+	};
+
+	template <typename T> inline void swap(T& lhs, T& rhs)
+	{
+		T temp = lhs;
+		lhs = rhs;
+		rhs = temp;
+	}
+
+	template <typename I, typename Pred> PUGI_IMPL_FN I min_element(I begin, I end, const Pred& pred)
+	{
+		I result = begin;
+
+		for (I it = begin + 1; it != end; ++it)
+			if (pred(*it, *result))
+				result = it;
+
+		return result;
+	}
+
+	template <typename I> PUGI_IMPL_FN void reverse(I begin, I end)
+	{
+		while (end - begin > 1)
+			swap(*begin++, *--end);
+	}
+
+	template <typename I> PUGI_IMPL_FN I unique(I begin, I end)
+	{
+		// fast skip head
+		while (end - begin > 1 && *begin != *(begin + 1))
+			begin++;
+
+		if (begin == end)
+			return begin;
+
+		// last written element
+		I write = begin++;
+
+		// merge unique elements
+		while (begin != end)
+		{
+			if (*begin != *write)
+				*++write = *begin++;
+			else
+				begin++;
+		}
+
+		// past-the-end (write points to live element)
+		return write + 1;
+	}
+
+	template <typename T, typename Pred> PUGI_IMPL_FN void insertion_sort(T* begin, T* end, const Pred& pred)
+	{
+		if (begin == end)
+			return;
+
+		for (T* it = begin + 1; it != end; ++it)
+		{
+			T val = *it;
+			T* hole = it;
+
+			// move hole backwards
+			while (hole > begin && pred(val, *(hole - 1)))
+			{
+				*hole = *(hole - 1);
+				hole--;
+			}
+
+			// fill hole with element
+			*hole = val;
+		}
+	}
+
+	template <typename I, typename Pred> inline I median3(I first, I middle, I last, const Pred& pred)
+	{
+		if (pred(*middle, *first))
+			swap(middle, first);
+		if (pred(*last, *middle))
+			swap(last, middle);
+		if (pred(*middle, *first))
+			swap(middle, first);
+
+		return middle;
+	}
+
+	template <typename T, typename Pred> PUGI_IMPL_FN void partition3(T* begin, T* end, T pivot, const Pred& pred, T** out_eqbeg, T** out_eqend)
+	{
+		// invariant: array is split into 4 groups: = < ? > (each variable denotes the boundary between the groups)
+		T* eq = begin;
+		T* lt = begin;
+		T* gt = end;
+
+		while (lt < gt)
+		{
+			if (pred(*lt, pivot))
+				lt++;
+			else if (*lt == pivot)
+				swap(*eq++, *lt++);
+			else
+				swap(*lt, *--gt);
+		}
+
+		// we now have just 4 groups: = < >; move equal elements to the middle
+		T* eqbeg = gt;
+
+		for (T* it = begin; it != eq; ++it)
+			swap(*it, *--eqbeg);
+
+		*out_eqbeg = eqbeg;
+		*out_eqend = gt;
+	}
+
+	template <typename I, typename Pred> PUGI_IMPL_FN void sort(I begin, I end, const Pred& pred)
+	{
+		// sort large chunks
+		while (end - begin > 16)
+		{
+			// find median element
+			I middle = begin + (end - begin) / 2;
+			I median = median3(begin, middle, end - 1, pred);
+
+			// partition in three chunks (< = >)
+			I eqbeg, eqend;
+			partition3(begin, end, *median, pred, &eqbeg, &eqend);
+
+			// loop on larger half
+			if (eqbeg - begin > end - eqend)
+			{
+				sort(eqend, end, pred);
+				end = eqbeg;
+			}
+			else
+			{
+				sort(begin, eqbeg, pred);
+				begin = eqend;
+			}
+		}
+
+		// insertion sort small chunk
+		insertion_sort(begin, end, pred);
+	}
+
+	PUGI_IMPL_FN bool hash_insert(const void** table, size_t size, const void* key)
+	{
+		assert(key);
+
+		unsigned int h = static_cast<unsigned int>(reinterpret_cast<uintptr_t>(key));
+
+		// MurmurHash3 32-bit finalizer
+		h ^= h >> 16;
+		h *= 0x85ebca6bu;
+		h ^= h >> 13;
+		h *= 0xc2b2ae35u;
+		h ^= h >> 16;
+
+		size_t hashmod = size - 1;
+		size_t bucket = h & hashmod;
+
+		for (size_t probe = 0; probe <= hashmod; ++probe)
+		{
+			if (table[bucket] == 0)
+			{
+				table[bucket] = key;
+				return true;
+			}
+
+			if (table[bucket] == key)
+				return false;
+
+			// hash collision, quadratic probing
+			bucket = (bucket + probe + 1) & hashmod;
+		}
+
+		assert(false && "Hash table is full"); // unreachable
+		return false;
+	}
+PUGI_IMPL_NS_END
+
+// Allocator used for AST and evaluation stacks
+PUGI_IMPL_NS_BEGIN
+	static const size_t xpath_memory_page_size =
+	#ifdef PUGIXML_MEMORY_XPATH_PAGE_SIZE
+		PUGIXML_MEMORY_XPATH_PAGE_SIZE
+	#else
+		4096
+	#endif
+		;
+
+	static const uintptr_t xpath_memory_block_alignment = sizeof(double) > sizeof(void*) ? sizeof(double) : sizeof(void*);
+
+	struct xpath_memory_block
+	{
+		xpath_memory_block* next;
+		size_t capacity;
+
+		union
+		{
+			char data[xpath_memory_page_size];
+			double alignment;
+		};
+	};
+
+	struct xpath_allocator
+	{
+		xpath_memory_block* _root;
+		size_t _root_size;
+		bool* _error;
+
+		xpath_allocator(xpath_memory_block* root, bool* error = 0): _root(root), _root_size(0), _error(error)
+		{
+		}
+
+		void* allocate(size_t size)
+		{
+			// round size up to block alignment boundary
+			size = (size + xpath_memory_block_alignment - 1) & ~(xpath_memory_block_alignment - 1);
+
+			if (_root_size + size <= _root->capacity)
+			{
+				void* buf = &_root->data[0] + _root_size;
+				_root_size += size;
+				return buf;
+			}
+			else
+			{
+				// make sure we have at least 1/4th of the page free after allocation to satisfy subsequent allocation requests
+				size_t block_capacity_base = sizeof(_root->data);
+				size_t block_capacity_req = size + block_capacity_base / 4;
+				size_t block_capacity = (block_capacity_base > block_capacity_req) ? block_capacity_base : block_capacity_req;
+
+				size_t block_size = block_capacity + offsetof(xpath_memory_block, data);
+
+				xpath_memory_block* block = static_cast<xpath_memory_block*>(xml_memory::allocate(block_size));
+				if (!block)
+				{
+					if (_error) *_error = true;
+					return 0;
+				}
+
+				block->next = _root;
+				block->capacity = block_capacity;
+
+				_root = block;
+				_root_size = size;
+
+				return block->data;
+			}
+		}
+
+		void* reallocate(void* ptr, size_t old_size, size_t new_size)
+		{
+			// round size up to block alignment boundary
+			old_size = (old_size + xpath_memory_block_alignment - 1) & ~(xpath_memory_block_alignment - 1);
+			new_size = (new_size + xpath_memory_block_alignment - 1) & ~(xpath_memory_block_alignment - 1);
+
+			// we can only reallocate the last object
+			assert(ptr == 0 || static_cast<char*>(ptr) + old_size == &_root->data[0] + _root_size);
+
+			// try to reallocate the object inplace
+			if (ptr && _root_size - old_size + new_size <= _root->capacity)
+			{
+				_root_size = _root_size - old_size + new_size;
+				return ptr;
+			}
+
+			// allocate a new block
+			void* result = allocate(new_size);
+			if (!result) return 0;
+
+			// we have a new block
+			if (ptr)
+			{
+				// copy old data (we only support growing)
+				assert(new_size >= old_size);
+				memcpy(result, ptr, old_size);
+
+				// free the previous page if it had no other objects
+				assert(_root->data == result);
+				assert(_root->next);
+
+				if (_root->next->data == ptr)
+				{
+					// deallocate the whole page, unless it was the first one
+					xpath_memory_block* next = _root->next->next;
+
+					if (next)
+					{
+						xml_memory::deallocate(_root->next);
+						_root->next = next;
+					}
+				}
+			}
+
+			return result;
+		}
+
+		void revert(const xpath_allocator& state)
+		{
+			// free all new pages
+			xpath_memory_block* cur = _root;
+
+			while (cur != state._root)
+			{
+				xpath_memory_block* next = cur->next;
+
+				xml_memory::deallocate(cur);
+
+				cur = next;
+			}
+
+			// restore state
+			_root = state._root;
+			_root_size = state._root_size;
+		}
+
+		void release()
+		{
+			xpath_memory_block* cur = _root;
+			assert(cur);
+
+			while (cur->next)
+			{
+				xpath_memory_block* next = cur->next;
+
+				xml_memory::deallocate(cur);
+
+				cur = next;
+			}
+		}
+	};
+
+	struct xpath_allocator_capture
+	{
+		xpath_allocator_capture(xpath_allocator* alloc): _target(alloc), _state(*alloc)
+		{
+		}
+
+		~xpath_allocator_capture()
+		{
+			_target->revert(_state);
+		}
+
+		xpath_allocator* _target;
+		xpath_allocator _state;
+	};
+
+	struct xpath_stack
+	{
+		xpath_allocator* result;
+		xpath_allocator* temp;
+	};
+
+	struct xpath_stack_data
+	{
+		xpath_memory_block blocks[2];
+		xpath_allocator result;
+		xpath_allocator temp;
+		xpath_stack stack;
+		bool oom;
+
+		xpath_stack_data(): result(blocks + 0, &oom), temp(blocks + 1, &oom), oom(false)
+		{
+			blocks[0].next = blocks[1].next = 0;
+			blocks[0].capacity = blocks[1].capacity = sizeof(blocks[0].data);
+
+			stack.result = &result;
+			stack.temp = &temp;
+		}
+
+		~xpath_stack_data()
+		{
+			result.release();
+			temp.release();
+		}
+	};
+PUGI_IMPL_NS_END
+
+// String class
+PUGI_IMPL_NS_BEGIN
+	class xpath_string
+	{
+		const char_t* _buffer;
+		bool _uses_heap;
+		size_t _length_heap;
+
+		static char_t* duplicate_string(const char_t* string, size_t length, xpath_allocator* alloc)
+		{
+			char_t* result = static_cast<char_t*>(alloc->allocate((length + 1) * sizeof(char_t)));
+			if (!result) return 0;
+
+			memcpy(result, string, length * sizeof(char_t));
+			result[length] = 0;
+
+			return result;
+		}
+
+		xpath_string(const char_t* buffer, bool uses_heap_, size_t length_heap): _buffer(buffer), _uses_heap(uses_heap_), _length_heap(length_heap)
+		{
+		}
+
+	public:
+		static xpath_string from_const(const char_t* str)
+		{
+			return xpath_string(str, false, 0);
+		}
+
+		static xpath_string from_heap_preallocated(const char_t* begin, const char_t* end)
+		{
+			assert(begin <= end && *end == 0);
+
+			return xpath_string(begin, true, static_cast<size_t>(end - begin));
+		}
+
+		static xpath_string from_heap(const char_t* begin, const char_t* end, xpath_allocator* alloc)
+		{
+			assert(begin <= end);
+
+			if (begin == end)
+				return xpath_string();
+
+			size_t length = static_cast<size_t>(end - begin);
+			const char_t* data = duplicate_string(begin, length, alloc);
+
+			return data ? xpath_string(data, true, length) : xpath_string();
+		}
+
+		xpath_string(): _buffer(PUGIXML_TEXT("")), _uses_heap(false), _length_heap(0)
+		{
+		}
+
+		void append(const xpath_string& o, xpath_allocator* alloc)
+		{
+			// skip empty sources
+			if (!*o._buffer) return;
+
+			// fast append for constant empty target and constant source
+			if (!*_buffer && !_uses_heap && !o._uses_heap)
+			{
+				_buffer = o._buffer;
+			}
+			else
+			{
+				// need to make heap copy
+				size_t target_length = length();
+				size_t source_length = o.length();
+				size_t result_length = target_length + source_length;
+
+				// allocate new buffer
+				char_t* result = static_cast<char_t*>(alloc->reallocate(_uses_heap ? const_cast<char_t*>(_buffer) : 0, (target_length + 1) * sizeof(char_t), (result_length + 1) * sizeof(char_t)));
+				if (!result) return;
+
+				// append first string to the new buffer in case there was no reallocation
+				if (!_uses_heap) memcpy(result, _buffer, target_length * sizeof(char_t));
+
+				// append second string to the new buffer
+				memcpy(result + target_length, o._buffer, source_length * sizeof(char_t));
+				result[result_length] = 0;
+
+				// finalize
+				_buffer = result;
+				_uses_heap = true;
+				_length_heap = result_length;
+			}
+		}
+
+		const char_t* c_str() const
+		{
+			return _buffer;
+		}
+
+		size_t length() const
+		{
+			return _uses_heap ? _length_heap : strlength(_buffer);
+		}
+
+		char_t* data(xpath_allocator* alloc)
+		{
+			// make private heap copy
+			if (!_uses_heap)
+			{
+				size_t length_ = strlength(_buffer);
+				const char_t* data_ = duplicate_string(_buffer, length_, alloc);
+
+				if (!data_) return 0;
+
+				_buffer = data_;
+				_uses_heap = true;
+				_length_heap = length_;
+			}
+
+			return const_cast<char_t*>(_buffer);
+		}
+
+		bool empty() const
+		{
+			return *_buffer == 0;
+		}
+
+		bool operator==(const xpath_string& o) const
+		{
+			return strequal(_buffer, o._buffer);
+		}
+
+		bool operator!=(const xpath_string& o) const
+		{
+			return !strequal(_buffer, o._buffer);
+		}
+
+		bool uses_heap() const
+		{
+			return _uses_heap;
+		}
+	};
+PUGI_IMPL_NS_END
+
+PUGI_IMPL_NS_BEGIN
+	PUGI_IMPL_FN bool starts_with(const char_t* string, const char_t* pattern)
+	{
+		while (*pattern && *string == *pattern)
+		{
+			string++;
+			pattern++;
+		}
+
+		return *pattern == 0;
+	}
+
+	PUGI_IMPL_FN const char_t* find_char(const char_t* s, char_t c)
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcschr(s, c);
+	#else
+		return strchr(s, c);
+	#endif
+	}
+
+	PUGI_IMPL_FN const char_t* find_substring(const char_t* s, const char_t* p)
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		// MSVC6 wcsstr bug workaround (if s is empty it always returns 0)
+		return (*p == 0) ? s : wcsstr(s, p);
+	#else
+		return strstr(s, p);
+	#endif
+	}
+
+	// Converts symbol to lower case, if it is an ASCII one
+	PUGI_IMPL_FN char_t tolower_ascii(char_t ch)
+	{
+		return static_cast<unsigned int>(ch - 'A') < 26 ? static_cast<char_t>(ch | ' ') : ch;
+	}
+
+	PUGI_IMPL_FN xpath_string string_value(const xpath_node& na, xpath_allocator* alloc)
+	{
+		if (na.attribute())
+			return xpath_string::from_const(na.attribute().value());
+		else
+		{
+			xml_node n = na.node();
+
+			switch (n.type())
+			{
+			case node_pcdata:
+			case node_cdata:
+			case node_comment:
+			case node_pi:
+				return xpath_string::from_const(n.value());
+
+			case node_document:
+			case node_element:
+			{
+				xpath_string result;
+
+				// element nodes can have value if parse_embed_pcdata was used
+				if (n.value()[0])
+					result.append(xpath_string::from_const(n.value()), alloc);
+
+				xml_node cur = n.first_child();
+
+				while (cur && cur != n)
+				{
+					if (cur.type() == node_pcdata || cur.type() == node_cdata)
+						result.append(xpath_string::from_const(cur.value()), alloc);
+
+					if (cur.first_child())
+						cur = cur.first_child();
+					else if (cur.next_sibling())
+						cur = cur.next_sibling();
+					else
+					{
+						while (!cur.next_sibling() && cur != n)
+							cur = cur.parent();
+
+						if (cur != n) cur = cur.next_sibling();
+					}
+				}
+
+				return result;
+			}
+
+			default:
+				return xpath_string();
+			}
+		}
+	}
+
+	PUGI_IMPL_FN bool node_is_before_sibling(xml_node_struct* ln, xml_node_struct* rn)
+	{
+		assert(ln->parent == rn->parent);
+
+		// there is no common ancestor (the shared parent is null), nodes are from different documents
+		if (!ln->parent) return ln < rn;
+
+		// determine sibling order
+		xml_node_struct* ls = ln;
+		xml_node_struct* rs = rn;
+
+		while (ls && rs)
+		{
+			if (ls == rn) return true;
+			if (rs == ln) return false;
+
+			ls = ls->next_sibling;
+			rs = rs->next_sibling;
+		}
+
+		// if rn sibling chain ended ln must be before rn
+		return !rs;
+	}
+
+	PUGI_IMPL_FN bool node_is_before(xml_node_struct* ln, xml_node_struct* rn)
+	{
+		// find common ancestor at the same depth, if any
+		xml_node_struct* lp = ln;
+		xml_node_struct* rp = rn;
+
+		while (lp && rp && lp->parent != rp->parent)
+		{
+			lp = lp->parent;
+			rp = rp->parent;
+		}
+
+		// parents are the same!
+		if (lp && rp) return node_is_before_sibling(lp, rp);
+
+		// nodes are at different depths, need to normalize heights
+		bool left_higher = !lp;
+
+		while (lp)
+		{
+			lp = lp->parent;
+			ln = ln->parent;
+		}
+
+		while (rp)
+		{
+			rp = rp->parent;
+			rn = rn->parent;
+		}
+
+		// one node is the ancestor of the other
+		if (ln == rn) return left_higher;
+
+		// find common ancestor... again
+		while (ln->parent != rn->parent)
+		{
+			ln = ln->parent;
+			rn = rn->parent;
+		}
+
+		return node_is_before_sibling(ln, rn);
+	}
+
+	PUGI_IMPL_FN bool node_is_ancestor(xml_node_struct* parent, xml_node_struct* node)
+	{
+		while (node && node != parent) node = node->parent;
+
+		return parent && node == parent;
+	}
+
+	PUGI_IMPL_FN const void* document_buffer_order(const xpath_node& xnode)
+	{
+		xml_node_struct* node = xnode.node().internal_object();
+
+		if (node)
+		{
+			if ((get_document(node).header & xml_memory_page_contents_shared_mask) == 0)
+			{
+				if (node->name && (node->header & impl::xml_memory_page_name_allocated_or_shared_mask) == 0) return node->name;
+				if (node->value && (node->header & impl::xml_memory_page_value_allocated_or_shared_mask) == 0) return node->value;
+			}
+
+			return 0;
+		}
+
+		xml_attribute_struct* attr = xnode.attribute().internal_object();
+
+		if (attr)
+		{
+			if ((get_document(attr).header & xml_memory_page_contents_shared_mask) == 0)
+			{
+				if ((attr->header & impl::xml_memory_page_name_allocated_or_shared_mask) == 0) return attr->name;
+				if ((attr->header & impl::xml_memory_page_value_allocated_or_shared_mask) == 0) return attr->value;
+			}
+
+			return 0;
+		}
+
+		return 0;
+	}
+
+	struct document_order_comparator
+	{
+		bool operator()(const xpath_node& lhs, const xpath_node& rhs) const
+		{
+			// optimized document order based check
+			const void* lo = document_buffer_order(lhs);
+			const void* ro = document_buffer_order(rhs);
+
+			if (lo && ro) return lo < ro;
+
+			// slow comparison
+			xml_node ln = lhs.node(), rn = rhs.node();
+
+			// compare attributes
+			if (lhs.attribute() && rhs.attribute())
+			{
+				// shared parent
+				if (lhs.parent() == rhs.parent())
+				{
+					// determine sibling order
+					for (xml_attribute a = lhs.attribute(); a; a = a.next_attribute())
+						if (a == rhs.attribute())
+							return true;
+
+					return false;
+				}
+
+				// compare attribute parents
+				ln = lhs.parent();
+				rn = rhs.parent();
+			}
+			else if (lhs.attribute())
+			{
+				// attributes go after the parent element
+				if (lhs.parent() == rhs.node()) return false;
+
+				ln = lhs.parent();
+			}
+			else if (rhs.attribute())
+			{
+				// attributes go after the parent element
+				if (rhs.parent() == lhs.node()) return true;
+
+				rn = rhs.parent();
+			}
+
+			if (ln == rn) return false;
+
+			if (!ln || !rn) return ln < rn;
+
+			return node_is_before(ln.internal_object(), rn.internal_object());
+		}
+	};
+
+	PUGI_IMPL_FN double gen_nan()
+	{
+	#if defined(__STDC_IEC_559__) || ((FLT_RADIX - 0 == 2) && (FLT_MAX_EXP - 0 == 128) && (FLT_MANT_DIG - 0 == 24))
+		PUGI_IMPL_STATIC_ASSERT(sizeof(float) == sizeof(uint32_t));
+		typedef uint32_t UI; // BCC5 workaround
+		union { float f; UI i; } u;
+		u.i = 0x7fc00000;
+		return double(u.f);
+	#else
+		// fallback
+		const volatile double zero = 0.0;
+		return zero / zero;
+	#endif
+	}
+
+	PUGI_IMPL_FN bool is_nan(double value)
+	{
+	#if defined(PUGI_IMPL_MSVC_CRT_VERSION) || defined(__BORLANDC__)
+		return !!_isnan(value);
+	#elif defined(fpclassify) && defined(FP_NAN)
+		return fpclassify(value) == FP_NAN;
+	#else
+		// fallback
+		const volatile double v = value;
+		return v != v;
+	#endif
+	}
+
+	PUGI_IMPL_FN const char_t* convert_number_to_string_special(double value)
+	{
+	#if defined(PUGI_IMPL_MSVC_CRT_VERSION) || defined(__BORLANDC__)
+		if (_finite(value)) return (value == 0) ? PUGIXML_TEXT("0") : 0;
+		if (_isnan(value)) return PUGIXML_TEXT("NaN");
+		return value > 0 ? PUGIXML_TEXT("Infinity") : PUGIXML_TEXT("-Infinity");
+	#elif defined(fpclassify) && defined(FP_NAN) && defined(FP_INFINITE) && defined(FP_ZERO)
+		switch (fpclassify(value))
+		{
+		case FP_NAN:
+			return PUGIXML_TEXT("NaN");
+
+		case FP_INFINITE:
+			return value > 0 ? PUGIXML_TEXT("Infinity") : PUGIXML_TEXT("-Infinity");
+
+		case FP_ZERO:
+			return PUGIXML_TEXT("0");
+
+		default:
+			return 0;
+		}
+	#else
+		// fallback
+		const volatile double v = value;
+
+		if (v == 0) return PUGIXML_TEXT("0");
+		if (v != v) return PUGIXML_TEXT("NaN");
+		if (v * 2 == v) return value > 0 ? PUGIXML_TEXT("Infinity") : PUGIXML_TEXT("-Infinity");
+		return 0;
+	#endif
+	}
+
+	PUGI_IMPL_FN bool convert_number_to_boolean(double value)
+	{
+		return (value != 0 && !is_nan(value));
+	}
+
+	PUGI_IMPL_FN void truncate_zeros(char* begin, char* end)
+	{
+		while (begin != end && end[-1] == '0') end--;
+
+		*end = 0;
+	}
+
+	// gets mantissa digits in the form of 0.xxxxx with 0. implied and the exponent
+#if defined(PUGI_IMPL_MSVC_CRT_VERSION) && PUGI_IMPL_MSVC_CRT_VERSION >= 1400
+	PUGI_IMPL_FN void convert_number_to_mantissa_exponent(double value, char (&buffer)[32], char** out_mantissa, int* out_exponent)
+	{
+		// get base values
+		int sign, exponent;
+		_ecvt_s(buffer, sizeof(buffer), value, DBL_DIG + 1, &exponent, &sign);
+
+		// truncate redundant zeros
+		truncate_zeros(buffer, buffer + strlen(buffer));
+
+		// fill results
+		*out_mantissa = buffer;
+		*out_exponent = exponent;
+	}
+#else
+	PUGI_IMPL_FN void convert_number_to_mantissa_exponent(double value, char (&buffer)[32], char** out_mantissa, int* out_exponent)
+	{
+		// get a scientific notation value with IEEE DBL_DIG decimals
+		PUGI_IMPL_SNPRINTF(buffer, "%.*e", DBL_DIG, value);
+
+		// get the exponent (possibly negative)
+		char* exponent_string = strchr(buffer, 'e');
+		assert(exponent_string);
+
+		int exponent = atoi(exponent_string + 1);
+
+		// extract mantissa string: skip sign
+		char* mantissa = buffer[0] == '-' ? buffer + 1 : buffer;
+		assert(mantissa[0] != '0' && (mantissa[1] == '.' || mantissa[1] == ','));
+
+		// divide mantissa by 10 to eliminate integer part
+		mantissa[1] = mantissa[0];
+		mantissa++;
+		exponent++;
+
+		// remove extra mantissa digits and zero-terminate mantissa
+		truncate_zeros(mantissa, exponent_string);
+
+		// fill results
+		*out_mantissa = mantissa;
+		*out_exponent = exponent;
+	}
+#endif
+
+	PUGI_IMPL_FN xpath_string convert_number_to_string(double value, xpath_allocator* alloc)
+	{
+		// try special number conversion
+		const char_t* special = convert_number_to_string_special(value);
+		if (special) return xpath_string::from_const(special);
+
+		// get mantissa + exponent form
+		char mantissa_buffer[32];
+
+		char* mantissa;
+		int exponent;
+		convert_number_to_mantissa_exponent(value, mantissa_buffer, &mantissa, &exponent);
+
+		// allocate a buffer of suitable length for the number
+		size_t result_size = strlen(mantissa_buffer) + (exponent > 0 ? exponent : -exponent) + 4;
+		char_t* result = static_cast<char_t*>(alloc->allocate(sizeof(char_t) * result_size));
+		if (!result) return xpath_string();
+
+		// make the number!
+		char_t* s = result;
+
+		// sign
+		if (value < 0) *s++ = '-';
+
+		// integer part
+		if (exponent <= 0)
+		{
+			*s++ = '0';
+		}
+		else
+		{
+			while (exponent > 0)
+			{
+				assert(*mantissa == 0 || static_cast<unsigned int>(*mantissa - '0') <= 9);
+				*s++ = *mantissa ? *mantissa++ : '0';
+				exponent--;
+			}
+		}
+
+		// fractional part
+		if (*mantissa)
+		{
+			// decimal point
+			*s++ = '.';
+
+			// extra zeroes from negative exponent
+			while (exponent < 0)
+			{
+				*s++ = '0';
+				exponent++;
+			}
+
+			// extra mantissa digits
+			while (*mantissa)
+			{
+				assert(static_cast<unsigned int>(*mantissa - '0') <= 9);
+				*s++ = *mantissa++;
+			}
+		}
+
+		// zero-terminate
+		assert(s < result + result_size);
+		*s = 0;
+
+		return xpath_string::from_heap_preallocated(result, s);
+	}
+
+	PUGI_IMPL_FN bool check_string_to_number_format(const char_t* string)
+	{
+		// parse leading whitespace
+		while (PUGI_IMPL_IS_CHARTYPE(*string, ct_space)) ++string;
+
+		// parse sign
+		if (*string == '-') ++string;
+
+		if (!*string) return false;
+
+		// if there is no integer part, there should be a decimal part with at least one digit
+		if (!PUGI_IMPL_IS_CHARTYPEX(string[0], ctx_digit) && (string[0] != '.' || !PUGI_IMPL_IS_CHARTYPEX(string[1], ctx_digit))) return false;
+
+		// parse integer part
+		while (PUGI_IMPL_IS_CHARTYPEX(*string, ctx_digit)) ++string;
+
+		// parse decimal part
+		if (*string == '.')
+		{
+			++string;
+
+			while (PUGI_IMPL_IS_CHARTYPEX(*string, ctx_digit)) ++string;
+		}
+
+		// parse trailing whitespace
+		while (PUGI_IMPL_IS_CHARTYPE(*string, ct_space)) ++string;
+
+		return *string == 0;
+	}
+
+	PUGI_IMPL_FN double convert_string_to_number(const char_t* string)
+	{
+		// check string format
+		if (!check_string_to_number_format(string)) return gen_nan();
+
+		// parse string
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcstod(string, 0);
+	#else
+		return strtod(string, 0);
+	#endif
+	}
+
+	PUGI_IMPL_FN bool convert_string_to_number_scratch(char_t (&buffer)[32], const char_t* begin, const char_t* end, double* out_result)
+	{
+		size_t length = static_cast<size_t>(end - begin);
+		char_t* scratch = buffer;
+
+		if (length >= sizeof(buffer) / sizeof(buffer[0]))
+		{
+			// need to make dummy on-heap copy
+			scratch = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+			if (!scratch) return false;
+		}
+
+		// copy string to zero-terminated buffer and perform conversion
+		memcpy(scratch, begin, length * sizeof(char_t));
+		scratch[length] = 0;
+
+		*out_result = convert_string_to_number(scratch);
+
+		// free dummy buffer
+		if (scratch != buffer) xml_memory::deallocate(scratch);
+
+		return true;
+	}
+
+	PUGI_IMPL_FN double round_nearest(double value)
+	{
+		return floor(value + 0.5);
+	}
+
+	PUGI_IMPL_FN double round_nearest_nzero(double value)
+	{
+		// same as round_nearest, but returns -0 for [-0.5, -0]
+		// ceil is used to differentiate between +0 and -0 (we return -0 for [-0.5, -0] and +0 for +0)
+		return (value >= -0.5 && value <= 0) ? ceil(value) : floor(value + 0.5);
+	}
+
+	PUGI_IMPL_FN const char_t* qualified_name(const xpath_node& node)
+	{
+		return node.attribute() ? node.attribute().name() : node.node().name();
+	}
+
+	PUGI_IMPL_FN const char_t* local_name(const xpath_node& node)
+	{
+		const char_t* name = qualified_name(node);
+		const char_t* p = find_char(name, ':');
+
+		return p ? p + 1 : name;
+	}
+
+	struct namespace_uri_predicate
+	{
+		const char_t* prefix;
+		size_t prefix_length;
+
+		namespace_uri_predicate(const char_t* name)
+		{
+			const char_t* pos = find_char(name, ':');
+
+			prefix = pos ? name : 0;
+			prefix_length = pos ? static_cast<size_t>(pos - name) : 0;
+		}
+
+		bool operator()(xml_attribute a) const
+		{
+			const char_t* name = a.name();
+
+			if (!starts_with(name, PUGIXML_TEXT("xmlns"))) return false;
+
+			return prefix ? name[5] == ':' && strequalrange(name + 6, prefix, prefix_length) : name[5] == 0;
+		}
+	};
+
+	PUGI_IMPL_FN const char_t* namespace_uri(xml_node node)
+	{
+		namespace_uri_predicate pred = node.name();
+
+		xml_node p = node;
+
+		while (p)
+		{
+			xml_attribute a = p.find_attribute(pred);
+
+			if (a) return a.value();
+
+			p = p.parent();
+		}
+
+		return PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const char_t* namespace_uri(xml_attribute attr, xml_node parent)
+	{
+		namespace_uri_predicate pred = attr.name();
+
+		// Default namespace does not apply to attributes
+		if (!pred.prefix) return PUGIXML_TEXT("");
+
+		xml_node p = parent;
+
+		while (p)
+		{
+			xml_attribute a = p.find_attribute(pred);
+
+			if (a) return a.value();
+
+			p = p.parent();
+		}
+
+		return PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const char_t* namespace_uri(const xpath_node& node)
+	{
+		return node.attribute() ? namespace_uri(node.attribute(), node.parent()) : namespace_uri(node.node());
+	}
+
+	PUGI_IMPL_FN char_t* normalize_space(char_t* buffer)
+	{
+		char_t* write = buffer;
+
+		for (char_t* it = buffer; *it; )
+		{
+			char_t ch = *it++;
+
+			if (PUGI_IMPL_IS_CHARTYPE(ch, ct_space))
+			{
+				// replace whitespace sequence with single space
+				while (PUGI_IMPL_IS_CHARTYPE(*it, ct_space)) it++;
+
+				// avoid leading spaces
+				if (write != buffer) *write++ = ' ';
+			}
+			else *write++ = ch;
+		}
+
+		// remove trailing space
+		if (write != buffer && PUGI_IMPL_IS_CHARTYPE(write[-1], ct_space)) write--;
+
+		// zero-terminate
+		*write = 0;
+
+		return write;
+	}
+
+	PUGI_IMPL_FN char_t* translate(char_t* buffer, const char_t* from, const char_t* to, size_t to_length)
+	{
+		char_t* write = buffer;
+
+		while (*buffer)
+		{
+			PUGI_IMPL_DMC_VOLATILE char_t ch = *buffer++;
+
+			const char_t* pos = find_char(from, ch);
+
+			if (!pos)
+				*write++ = ch; // do not process
+			else if (static_cast<size_t>(pos - from) < to_length)
+				*write++ = to[pos - from]; // replace
+		}
+
+		// zero-terminate
+		*write = 0;
+
+		return write;
+	}
+
+	PUGI_IMPL_FN unsigned char* translate_table_generate(xpath_allocator* alloc, const char_t* from, const char_t* to)
+	{
+		unsigned char table[128] = {0};
+
+		while (*from)
+		{
+			unsigned int fc = static_cast<unsigned int>(*from);
+			unsigned int tc = static_cast<unsigned int>(*to);
+
+			if (fc >= 128 || tc >= 128)
+				return 0;
+
+			// code=128 means "skip character"
+			if (!table[fc])
+				table[fc] = static_cast<unsigned char>(tc ? tc : 128);
+
+			from++;
+			if (tc) to++;
+		}
+
+		for (int i = 0; i < 128; ++i)
+			if (!table[i])
+				table[i] = static_cast<unsigned char>(i);
+
+		void* result = alloc->allocate(sizeof(table));
+		if (!result) return 0;
+
+		memcpy(result, table, sizeof(table));
+
+		return static_cast<unsigned char*>(result);
+	}
+
+	PUGI_IMPL_FN char_t* translate_table(char_t* buffer, const unsigned char* table)
+	{
+		char_t* write = buffer;
+
+		while (*buffer)
+		{
+			char_t ch = *buffer++;
+			unsigned int index = static_cast<unsigned int>(ch);
+
+			if (index < 128)
+			{
+				unsigned char code = table[index];
+
+				// code=128 means "skip character" (table size is 128 so 128 can be a special value)
+				// this code skips these characters without extra branches
+				*write = static_cast<char_t>(code);
+				write += 1 - (code >> 7);
+			}
+			else
+			{
+				*write++ = ch;
+			}
+		}
+
+		// zero-terminate
+		*write = 0;
+
+		return write;
+	}
+
+	inline bool is_xpath_attribute(const char_t* name)
+	{
+		return !(starts_with(name, PUGIXML_TEXT("xmlns")) && (name[5] == 0 || name[5] == ':'));
+	}
+
+	struct xpath_variable_boolean: xpath_variable
+	{
+		xpath_variable_boolean(): xpath_variable(xpath_type_boolean), value(false)
+		{
+		}
+
+		bool value;
+		char_t name[1];
+	};
+
+	struct xpath_variable_number: xpath_variable
+	{
+		xpath_variable_number(): xpath_variable(xpath_type_number), value(0)
+		{
+		}
+
+		double value;
+		char_t name[1];
+	};
+
+	struct xpath_variable_string: xpath_variable
+	{
+		xpath_variable_string(): xpath_variable(xpath_type_string), value(0)
+		{
+		}
+
+		~xpath_variable_string()
+		{
+			if (value) xml_memory::deallocate(value);
+		}
+
+		char_t* value;
+		char_t name[1];
+	};
+
+	struct xpath_variable_node_set: xpath_variable
+	{
+		xpath_variable_node_set(): xpath_variable(xpath_type_node_set)
+		{
+		}
+
+		xpath_node_set value;
+		char_t name[1];
+	};
+
+	static const xpath_node_set dummy_node_set;
+
+	PUGI_IMPL_FN PUGI_IMPL_UNSIGNED_OVERFLOW unsigned int hash_string(const char_t* str)
+	{
+		// Jenkins one-at-a-time hash (http://en.wikipedia.org/wiki/Jenkins_hash_function#one-at-a-time)
+		unsigned int result = 0;
+
+		while (*str)
+		{
+			result += static_cast<unsigned int>(*str++);
+			result += result << 10;
+			result ^= result >> 6;
+		}
+
+		result += result << 3;
+		result ^= result >> 11;
+		result += result << 15;
+
+		return result;
+	}
+
+	template <typename T> PUGI_IMPL_FN T* new_xpath_variable(const char_t* name)
+	{
+		size_t length = strlength(name);
+		if (length == 0) return 0; // empty variable names are invalid
+
+		// $$ we can't use offsetof(T, name) because T is non-POD, so we just allocate additional length characters
+		void* memory = xml_memory::allocate(sizeof(T) + length * sizeof(char_t));
+		if (!memory) return 0;
+
+		T* result = new (memory) T();
+
+		memcpy(result->name, name, (length + 1) * sizeof(char_t));
+
+		return result;
+	}
+
+	PUGI_IMPL_FN xpath_variable* new_xpath_variable(xpath_value_type type, const char_t* name)
+	{
+		switch (type)
+		{
+		case xpath_type_node_set:
+			return new_xpath_variable<xpath_variable_node_set>(name);
+
+		case xpath_type_number:
+			return new_xpath_variable<xpath_variable_number>(name);
+
+		case xpath_type_string:
+			return new_xpath_variable<xpath_variable_string>(name);
+
+		case xpath_type_boolean:
+			return new_xpath_variable<xpath_variable_boolean>(name);
+
+		default:
+			return 0;
+		}
+	}
+
+	template <typename T> PUGI_IMPL_FN void delete_xpath_variable(T* var)
+	{
+		var->~T();
+		xml_memory::deallocate(var);
+	}
+
+	PUGI_IMPL_FN void delete_xpath_variable(xpath_value_type type, xpath_variable* var)
+	{
+		switch (type)
+		{
+		case xpath_type_node_set:
+			delete_xpath_variable(static_cast<xpath_variable_node_set*>(var));
+			break;
+
+		case xpath_type_number:
+			delete_xpath_variable(static_cast<xpath_variable_number*>(var));
+			break;
+
+		case xpath_type_string:
+			delete_xpath_variable(static_cast<xpath_variable_string*>(var));
+			break;
+
+		case xpath_type_boolean:
+			delete_xpath_variable(static_cast<xpath_variable_boolean*>(var));
+			break;
+
+		default:
+			assert(false && "Invalid variable type"); // unreachable
+		}
+	}
+
+	PUGI_IMPL_FN bool copy_xpath_variable(xpath_variable* lhs, const xpath_variable* rhs)
+	{
+		switch (rhs->type())
+		{
+		case xpath_type_node_set:
+			return lhs->set(static_cast<const xpath_variable_node_set*>(rhs)->value);
+
+		case xpath_type_number:
+			return lhs->set(static_cast<const xpath_variable_number*>(rhs)->value);
+
+		case xpath_type_string:
+			return lhs->set(static_cast<const xpath_variable_string*>(rhs)->value);
+
+		case xpath_type_boolean:
+			return lhs->set(static_cast<const xpath_variable_boolean*>(rhs)->value);
+
+		default:
+			assert(false && "Invalid variable type"); // unreachable
+			return false;
+		}
+	}
+
+	PUGI_IMPL_FN bool get_variable_scratch(char_t (&buffer)[32], xpath_variable_set* set, const char_t* begin, const char_t* end, xpath_variable** out_result)
+	{
+		size_t length = static_cast<size_t>(end - begin);
+		char_t* scratch = buffer;
+
+		if (length >= sizeof(buffer) / sizeof(buffer[0]))
+		{
+			// need to make dummy on-heap copy
+			scratch = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+			if (!scratch) return false;
+		}
+
+		// copy string to zero-terminated buffer and perform lookup
+		memcpy(scratch, begin, length * sizeof(char_t));
+		scratch[length] = 0;
+
+		*out_result = set->get(scratch);
+
+		// free dummy buffer
+		if (scratch != buffer) xml_memory::deallocate(scratch);
+
+		return true;
+	}
+PUGI_IMPL_NS_END
+
+// Internal node set class
+PUGI_IMPL_NS_BEGIN
+	PUGI_IMPL_FN xpath_node_set::type_t xpath_get_order(const xpath_node* begin, const xpath_node* end)
+	{
+		if (end - begin < 2)
+			return xpath_node_set::type_sorted;
+
+		document_order_comparator cmp;
+
+		bool first = cmp(begin[0], begin[1]);
+
+		for (const xpath_node* it = begin + 1; it + 1 < end; ++it)
+			if (cmp(it[0], it[1]) != first)
+				return xpath_node_set::type_unsorted;
+
+		return first ? xpath_node_set::type_sorted : xpath_node_set::type_sorted_reverse;
+	}
+
+	PUGI_IMPL_FN xpath_node_set::type_t xpath_sort(xpath_node* begin, xpath_node* end, xpath_node_set::type_t type, bool rev)
+	{
+		xpath_node_set::type_t order = rev ? xpath_node_set::type_sorted_reverse : xpath_node_set::type_sorted;
+
+		if (type == xpath_node_set::type_unsorted)
+		{
+			xpath_node_set::type_t sorted = xpath_get_order(begin, end);
+
+			if (sorted == xpath_node_set::type_unsorted)
+			{
+				sort(begin, end, document_order_comparator());
+
+				type = xpath_node_set::type_sorted;
+			}
+			else
+				type = sorted;
+		}
+
+		if (type != order) reverse(begin, end);
+
+		return order;
+	}
+
+	PUGI_IMPL_FN xpath_node xpath_first(const xpath_node* begin, const xpath_node* end, xpath_node_set::type_t type)
+	{
+		if (begin == end) return xpath_node();
+
+		switch (type)
+		{
+		case xpath_node_set::type_sorted:
+			return *begin;
+
+		case xpath_node_set::type_sorted_reverse:
+			return *(end - 1);
+
+		case xpath_node_set::type_unsorted:
+			return *min_element(begin, end, document_order_comparator());
+
+		default:
+			assert(false && "Invalid node set type"); // unreachable
+			return xpath_node();
+		}
+	}
+
+	class xpath_node_set_raw
+	{
+		xpath_node_set::type_t _type;
+
+		xpath_node* _begin;
+		xpath_node* _end;
+		xpath_node* _eos;
+
+	public:
+		xpath_node_set_raw(): _type(xpath_node_set::type_unsorted), _begin(0), _end(0), _eos(0)
+		{
+		}
+
+		xpath_node* begin() const
+		{
+			return _begin;
+		}
+
+		xpath_node* end() const
+		{
+			return _end;
+		}
+
+		bool empty() const
+		{
+			return _begin == _end;
+		}
+
+		size_t size() const
+		{
+			return static_cast<size_t>(_end - _begin);
+		}
+
+		xpath_node first() const
+		{
+			return xpath_first(_begin, _end, _type);
+		}
+
+		void push_back_grow(const xpath_node& node, xpath_allocator* alloc);
+
+		void push_back(const xpath_node& node, xpath_allocator* alloc)
+		{
+			if (_end != _eos)
+				*_end++ = node;
+			else
+				push_back_grow(node, alloc);
+		}
+
+		void append(const xpath_node* begin_, const xpath_node* end_, xpath_allocator* alloc)
+		{
+			if (begin_ == end_) return;
+
+			size_t size_ = static_cast<size_t>(_end - _begin);
+			size_t capacity = static_cast<size_t>(_eos - _begin);
+			size_t count = static_cast<size_t>(end_ - begin_);
+
+			if (size_ + count > capacity)
+			{
+				// reallocate the old array or allocate a new one
+				xpath_node* data = static_cast<xpath_node*>(alloc->reallocate(_begin, capacity * sizeof(xpath_node), (size_ + count) * sizeof(xpath_node)));
+				if (!data) return;
+
+				// finalize
+				_begin = data;
+				_end = data + size_;
+				_eos = data + size_ + count;
+			}
+
+			memcpy(_end, begin_, count * sizeof(xpath_node));
+			_end += count;
+		}
+
+		void sort_do()
+		{
+			_type = xpath_sort(_begin, _end, _type, false);
+		}
+
+		void truncate(xpath_node* pos)
+		{
+			assert(_begin <= pos && pos <= _end);
+
+			_end = pos;
+		}
+
+		void remove_duplicates(xpath_allocator* alloc)
+		{
+			if (_type == xpath_node_set::type_unsorted && _end - _begin > 2)
+			{
+				xpath_allocator_capture cr(alloc);
+
+				size_t size_ = static_cast<size_t>(_end - _begin);
+
+				size_t hash_size = 1;
+				while (hash_size < size_ + size_ / 2) hash_size *= 2;
+
+				const void** hash_data = static_cast<const void**>(alloc->allocate(hash_size * sizeof(void**)));
+				if (!hash_data) return;
+
+				memset(hash_data, 0, hash_size * sizeof(const void**));
+
+				xpath_node* write = _begin;
+
+				for (xpath_node* it = _begin; it != _end; ++it)
+				{
+					const void* attr = it->attribute().internal_object();
+					const void* node = it->node().internal_object();
+					const void* key = attr ? attr : node;
+
+					if (key && hash_insert(hash_data, hash_size, key))
+					{
+						*write++ = *it;
+					}
+				}
+
+				_end = write;
+			}
+			else
+			{
+				_end = unique(_begin, _end);
+			}
+		}
+
+		xpath_node_set::type_t type() const
+		{
+			return _type;
+		}
+
+		void set_type(xpath_node_set::type_t value)
+		{
+			_type = value;
+		}
+	};
+
+	PUGI_IMPL_FN_NO_INLINE void xpath_node_set_raw::push_back_grow(const xpath_node& node, xpath_allocator* alloc)
+	{
+		size_t capacity = static_cast<size_t>(_eos - _begin);
+
+		// get new capacity (1.5x rule)
+		size_t new_capacity = capacity + capacity / 2 + 1;
+
+		// reallocate the old array or allocate a new one
+		xpath_node* data = static_cast<xpath_node*>(alloc->reallocate(_begin, capacity * sizeof(xpath_node), new_capacity * sizeof(xpath_node)));
+		if (!data) return;
+
+		// finalize
+		_begin = data;
+		_end = data + capacity;
+		_eos = data + new_capacity;
+
+		// push
+		*_end++ = node;
+	}
+PUGI_IMPL_NS_END
+
+PUGI_IMPL_NS_BEGIN
+	struct xpath_context
+	{
+		xpath_node n;
+		size_t position, size;
+
+		xpath_context(const xpath_node& n_, size_t position_, size_t size_): n(n_), position(position_), size(size_)
+		{
+		}
+	};
+
+	enum lexeme_t
+	{
+		lex_none = 0,
+		lex_equal,
+		lex_not_equal,
+		lex_less,
+		lex_greater,
+		lex_less_or_equal,
+		lex_greater_or_equal,
+		lex_plus,
+		lex_minus,
+		lex_multiply,
+		lex_union,
+		lex_var_ref,
+		lex_open_brace,
+		lex_close_brace,
+		lex_quoted_string,
+		lex_number,
+		lex_slash,
+		lex_double_slash,
+		lex_open_square_brace,
+		lex_close_square_brace,
+		lex_string,
+		lex_comma,
+		lex_axis_attribute,
+		lex_dot,
+		lex_double_dot,
+		lex_double_colon,
+		lex_eof
+	};
+
+	struct xpath_lexer_string
+	{
+		const char_t* begin;
+		const char_t* end;
+
+		xpath_lexer_string(): begin(0), end(0)
+		{
+		}
+
+		bool operator==(const char_t* other) const
+		{
+			size_t length = static_cast<size_t>(end - begin);
+
+			return strequalrange(other, begin, length);
+		}
+	};
+
+	class xpath_lexer
+	{
+		const char_t* _cur;
+		const char_t* _cur_lexeme_pos;
+		xpath_lexer_string _cur_lexeme_contents;
+
+		lexeme_t _cur_lexeme;
+
+	public:
+		explicit xpath_lexer(const char_t* query): _cur(query)
+		{
+			next();
+		}
+
+		const char_t* state() const
+		{
+			return _cur;
+		}
+
+		void next()
+		{
+			const char_t* cur = _cur;
+
+			while (PUGI_IMPL_IS_CHARTYPE(*cur, ct_space)) ++cur;
+
+			// save lexeme position for error reporting
+			_cur_lexeme_pos = cur;
+
+			switch (*cur)
+			{
+			case 0:
+				_cur_lexeme = lex_eof;
+				break;
+
+			case '>':
+				if (*(cur+1) == '=')
+				{
+					cur += 2;
+					_cur_lexeme = lex_greater_or_equal;
+				}
+				else
+				{
+					cur += 1;
+					_cur_lexeme = lex_greater;
+				}
+				break;
+
+			case '<':
+				if (*(cur+1) == '=')
+				{
+					cur += 2;
+					_cur_lexeme = lex_less_or_equal;
+				}
+				else
+				{
+					cur += 1;
+					_cur_lexeme = lex_less;
+				}
+				break;
+
+			case '!':
+				if (*(cur+1) == '=')
+				{
+					cur += 2;
+					_cur_lexeme = lex_not_equal;
+				}
+				else
+				{
+					_cur_lexeme = lex_none;
+				}
+				break;
+
+			case '=':
+				cur += 1;
+				_cur_lexeme = lex_equal;
+
+				break;
+
+			case '+':
+				cur += 1;
+				_cur_lexeme = lex_plus;
+
+				break;
+
+			case '-':
+				cur += 1;
+				_cur_lexeme = lex_minus;
+
+				break;
+
+			case '*':
+				cur += 1;
+				_cur_lexeme = lex_multiply;
+
+				break;
+
+			case '|':
+				cur += 1;
+				_cur_lexeme = lex_union;
+
+				break;
+
+			case '$':
+				cur += 1;
+
+				if (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_start_symbol))
+				{
+					_cur_lexeme_contents.begin = cur;
+
+					while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_symbol)) cur++;
+
+					if (cur[0] == ':' && PUGI_IMPL_IS_CHARTYPEX(cur[1], ctx_symbol)) // qname
+					{
+						cur++; // :
+
+						while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_symbol)) cur++;
+					}
+
+					_cur_lexeme_contents.end = cur;
+
+					_cur_lexeme = lex_var_ref;
+				}
+				else
+				{
+					_cur_lexeme = lex_none;
+				}
+
+				break;
+
+			case '(':
+				cur += 1;
+				_cur_lexeme = lex_open_brace;
+
+				break;
+
+			case ')':
+				cur += 1;
+				_cur_lexeme = lex_close_brace;
+
+				break;
+
+			case '[':
+				cur += 1;
+				_cur_lexeme = lex_open_square_brace;
+
+				break;
+
+			case ']':
+				cur += 1;
+				_cur_lexeme = lex_close_square_brace;
+
+				break;
+
+			case ',':
+				cur += 1;
+				_cur_lexeme = lex_comma;
+
+				break;
+
+			case '/':
+				if (*(cur+1) == '/')
+				{
+					cur += 2;
+					_cur_lexeme = lex_double_slash;
+				}
+				else
+				{
+					cur += 1;
+					_cur_lexeme = lex_slash;
+				}
+				break;
+
+			case '.':
+				if (*(cur+1) == '.')
+				{
+					cur += 2;
+					_cur_lexeme = lex_double_dot;
+				}
+				else if (PUGI_IMPL_IS_CHARTYPEX(*(cur+1), ctx_digit))
+				{
+					_cur_lexeme_contents.begin = cur; // .
+
+					++cur;
+
+					while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_digit)) cur++;
+
+					_cur_lexeme_contents.end = cur;
+
+					_cur_lexeme = lex_number;
+				}
+				else
+				{
+					cur += 1;
+					_cur_lexeme = lex_dot;
+				}
+				break;
+
+			case '@':
+				cur += 1;
+				_cur_lexeme = lex_axis_attribute;
+
+				break;
+
+			case '"':
+			case '\'':
+			{
+				char_t terminator = *cur;
+
+				++cur;
+
+				_cur_lexeme_contents.begin = cur;
+				while (*cur && *cur != terminator) cur++;
+				_cur_lexeme_contents.end = cur;
+
+				if (!*cur)
+					_cur_lexeme = lex_none;
+				else
+				{
+					cur += 1;
+					_cur_lexeme = lex_quoted_string;
+				}
+
+				break;
+			}
+
+			case ':':
+				if (*(cur+1) == ':')
+				{
+					cur += 2;
+					_cur_lexeme = lex_double_colon;
+				}
+				else
+				{
+					_cur_lexeme = lex_none;
+				}
+				break;
+
+			default:
+				if (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_digit))
+				{
+					_cur_lexeme_contents.begin = cur;
+
+					while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_digit)) cur++;
+
+					if (*cur == '.')
+					{
+						cur++;
+
+						while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_digit)) cur++;
+					}
+
+					_cur_lexeme_contents.end = cur;
+
+					_cur_lexeme = lex_number;
+				}
+				else if (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_start_symbol))
+				{
+					_cur_lexeme_contents.begin = cur;
+
+					while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_symbol)) cur++;
+
+					if (cur[0] == ':')
+					{
+						if (cur[1] == '*') // namespace test ncname:*
+						{
+							cur += 2; // :*
+						}
+						else if (PUGI_IMPL_IS_CHARTYPEX(cur[1], ctx_symbol)) // namespace test qname
+						{
+							cur++; // :
+
+							while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_symbol)) cur++;
+						}
+					}
+
+					_cur_lexeme_contents.end = cur;
+
+					_cur_lexeme = lex_string;
+				}
+				else
+				{
+					_cur_lexeme = lex_none;
+				}
+			}
+
+			_cur = cur;
+		}
+
+		lexeme_t current() const
+		{
+			return _cur_lexeme;
+		}
+
+		const char_t* current_pos() const
+		{
+			return _cur_lexeme_pos;
+		}
+
+		const xpath_lexer_string& contents() const
+		{
+			assert(_cur_lexeme == lex_var_ref || _cur_lexeme == lex_number || _cur_lexeme == lex_string || _cur_lexeme == lex_quoted_string);
+
+			return _cur_lexeme_contents;
+		}
+	};
+
+	enum ast_type_t
+	{
+		ast_unknown,
+		ast_op_or,						// left or right
+		ast_op_and,						// left and right
+		ast_op_equal,					// left = right
+		ast_op_not_equal,				// left != right
+		ast_op_less,					// left < right
+		ast_op_greater,					// left > right
+		ast_op_less_or_equal,			// left <= right
+		ast_op_greater_or_equal,		// left >= right
+		ast_op_add,						// left + right
+		ast_op_subtract,				// left - right
+		ast_op_multiply,				// left * right
+		ast_op_divide,					// left / right
+		ast_op_mod,						// left % right
+		ast_op_negate,					// left - right
+		ast_op_union,					// left | right
+		ast_predicate,					// apply predicate to set; next points to next predicate
+		ast_filter,						// select * from left where right
+		ast_string_constant,			// string constant
+		ast_number_constant,			// number constant
+		ast_variable,					// variable
+		ast_func_last,					// last()
+		ast_func_position,				// position()
+		ast_func_count,					// count(left)
+		ast_func_id,					// id(left)
+		ast_func_local_name_0,			// local-name()
+		ast_func_local_name_1,			// local-name(left)
+		ast_func_namespace_uri_0,		// namespace-uri()
+		ast_func_namespace_uri_1,		// namespace-uri(left)
+		ast_func_name_0,				// name()
+		ast_func_name_1,				// name(left)
+		ast_func_string_0,				// string()
+		ast_func_string_1,				// string(left)
+		ast_func_concat,				// concat(left, right, siblings)
+		ast_func_starts_with,			// starts_with(left, right)
+		ast_func_contains,				// contains(left, right)
+		ast_func_substring_before,		// substring-before(left, right)
+		ast_func_substring_after,		// substring-after(left, right)
+		ast_func_substring_2,			// substring(left, right)
+		ast_func_substring_3,			// substring(left, right, third)
+		ast_func_string_length_0,		// string-length()
+		ast_func_string_length_1,		// string-length(left)
+		ast_func_normalize_space_0,		// normalize-space()
+		ast_func_normalize_space_1,		// normalize-space(left)
+		ast_func_translate,				// translate(left, right, third)
+		ast_func_boolean,				// boolean(left)
+		ast_func_not,					// not(left)
+		ast_func_true,					// true()
+		ast_func_false,					// false()
+		ast_func_lang,					// lang(left)
+		ast_func_number_0,				// number()
+		ast_func_number_1,				// number(left)
+		ast_func_sum,					// sum(left)
+		ast_func_floor,					// floor(left)
+		ast_func_ceiling,				// ceiling(left)
+		ast_func_round,					// round(left)
+		ast_step,						// process set left with step
+		ast_step_root,					// select root node
+
+		ast_opt_translate_table,		// translate(left, right, third) where right/third are constants
+		ast_opt_compare_attribute		// @name = 'string'
+	};
+
+	enum axis_t
+	{
+		axis_ancestor,
+		axis_ancestor_or_self,
+		axis_attribute,
+		axis_child,
+		axis_descendant,
+		axis_descendant_or_self,
+		axis_following,
+		axis_following_sibling,
+		axis_namespace,
+		axis_parent,
+		axis_preceding,
+		axis_preceding_sibling,
+		axis_self
+	};
+
+	enum nodetest_t
+	{
+		nodetest_none,
+		nodetest_name,
+		nodetest_type_node,
+		nodetest_type_comment,
+		nodetest_type_pi,
+		nodetest_type_text,
+		nodetest_pi,
+		nodetest_all,
+		nodetest_all_in_namespace
+	};
+
+	enum predicate_t
+	{
+		predicate_default,
+		predicate_posinv,
+		predicate_constant,
+		predicate_constant_one
+	};
+
+	enum nodeset_eval_t
+	{
+		nodeset_eval_all,
+		nodeset_eval_any,
+		nodeset_eval_first
+	};
+
+	template <axis_t N> struct axis_to_type
+	{
+		static const axis_t axis;
+	};
+
+	template <axis_t N> const axis_t axis_to_type<N>::axis = N;
+
+	class xpath_ast_node
+	{
+	private:
+		// node type
+		char _type;
+		char _rettype;
+
+		// for ast_step
+		char _axis;
+
+		// for ast_step/ast_predicate/ast_filter
+		char _test;
+
+		// tree node structure
+		xpath_ast_node* _left;
+		xpath_ast_node* _right;
+		xpath_ast_node* _next;
+
+		union
+		{
+			// value for ast_string_constant
+			const char_t* string;
+			// value for ast_number_constant
+			double number;
+			// variable for ast_variable
+			xpath_variable* variable;
+			// node test for ast_step (node name/namespace/node type/pi target)
+			const char_t* nodetest;
+			// table for ast_opt_translate_table
+			const unsigned char* table;
+		} _data;
+
+		xpath_ast_node(const xpath_ast_node&);
+		xpath_ast_node& operator=(const xpath_ast_node&);
+
+		template <class Comp> static bool compare_eq(xpath_ast_node* lhs, xpath_ast_node* rhs, const xpath_context& c, const xpath_stack& stack, const Comp& comp)
+		{
+			xpath_value_type lt = lhs->rettype(), rt = rhs->rettype();
+
+			if (lt != xpath_type_node_set && rt != xpath_type_node_set)
+			{
+				if (lt == xpath_type_boolean || rt == xpath_type_boolean)
+					return comp(lhs->eval_boolean(c, stack), rhs->eval_boolean(c, stack));
+				else if (lt == xpath_type_number || rt == xpath_type_number)
+					return comp(lhs->eval_number(c, stack), rhs->eval_number(c, stack));
+				else if (lt == xpath_type_string || rt == xpath_type_string)
+				{
+					xpath_allocator_capture cr(stack.result);
+
+					xpath_string ls = lhs->eval_string(c, stack);
+					xpath_string rs = rhs->eval_string(c, stack);
+
+					return comp(ls, rs);
+				}
+			}
+			else if (lt == xpath_type_node_set && rt == xpath_type_node_set)
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ls = lhs->eval_node_set(c, stack, nodeset_eval_all);
+				xpath_node_set_raw rs = rhs->eval_node_set(c, stack, nodeset_eval_all);
+
+				for (const xpath_node* li = ls.begin(); li != ls.end(); ++li)
+					for (const xpath_node* ri = rs.begin(); ri != rs.end(); ++ri)
+					{
+						xpath_allocator_capture cri(stack.result);
+
+						if (comp(string_value(*li, stack.result), string_value(*ri, stack.result)))
+							return true;
+					}
+
+				return false;
+			}
+			else
+			{
+				if (lt == xpath_type_node_set)
+				{
+					swap(lhs, rhs);
+					swap(lt, rt);
+				}
+
+				if (lt == xpath_type_boolean)
+					return comp(lhs->eval_boolean(c, stack), rhs->eval_boolean(c, stack));
+				else if (lt == xpath_type_number)
+				{
+					xpath_allocator_capture cr(stack.result);
+
+					double l = lhs->eval_number(c, stack);
+					xpath_node_set_raw rs = rhs->eval_node_set(c, stack, nodeset_eval_all);
+
+					for (const xpath_node* ri = rs.begin(); ri != rs.end(); ++ri)
+					{
+						xpath_allocator_capture cri(stack.result);
+
+						if (comp(l, convert_string_to_number(string_value(*ri, stack.result).c_str())))
+							return true;
+					}
+
+					return false;
+				}
+				else if (lt == xpath_type_string)
+				{
+					xpath_allocator_capture cr(stack.result);
+
+					xpath_string l = lhs->eval_string(c, stack);
+					xpath_node_set_raw rs = rhs->eval_node_set(c, stack, nodeset_eval_all);
+
+					for (const xpath_node* ri = rs.begin(); ri != rs.end(); ++ri)
+					{
+						xpath_allocator_capture cri(stack.result);
+
+						if (comp(l, string_value(*ri, stack.result)))
+							return true;
+					}
+
+					return false;
+				}
+			}
+
+			assert(false && "Wrong types"); // unreachable
+			return false;
+		}
+
+		static bool eval_once(xpath_node_set::type_t type, nodeset_eval_t eval)
+		{
+			return type == xpath_node_set::type_sorted ? eval != nodeset_eval_all : eval == nodeset_eval_any;
+		}
+
+		template <class Comp> static bool compare_rel(xpath_ast_node* lhs, xpath_ast_node* rhs, const xpath_context& c, const xpath_stack& stack, const Comp& comp)
+		{
+			xpath_value_type lt = lhs->rettype(), rt = rhs->rettype();
+
+			if (lt != xpath_type_node_set && rt != xpath_type_node_set)
+				return comp(lhs->eval_number(c, stack), rhs->eval_number(c, stack));
+			else if (lt == xpath_type_node_set && rt == xpath_type_node_set)
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ls = lhs->eval_node_set(c, stack, nodeset_eval_all);
+				xpath_node_set_raw rs = rhs->eval_node_set(c, stack, nodeset_eval_all);
+
+				for (const xpath_node* li = ls.begin(); li != ls.end(); ++li)
+				{
+					xpath_allocator_capture cri(stack.result);
+
+					double l = convert_string_to_number(string_value(*li, stack.result).c_str());
+
+					for (const xpath_node* ri = rs.begin(); ri != rs.end(); ++ri)
+					{
+						xpath_allocator_capture crii(stack.result);
+
+						if (comp(l, convert_string_to_number(string_value(*ri, stack.result).c_str())))
+							return true;
+					}
+				}
+
+				return false;
+			}
+			else if (lt != xpath_type_node_set && rt == xpath_type_node_set)
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				double l = lhs->eval_number(c, stack);
+				xpath_node_set_raw rs = rhs->eval_node_set(c, stack, nodeset_eval_all);
+
+				for (const xpath_node* ri = rs.begin(); ri != rs.end(); ++ri)
+				{
+					xpath_allocator_capture cri(stack.result);
+
+					if (comp(l, convert_string_to_number(string_value(*ri, stack.result).c_str())))
+						return true;
+				}
+
+				return false;
+			}
+			else if (lt == xpath_type_node_set && rt != xpath_type_node_set)
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ls = lhs->eval_node_set(c, stack, nodeset_eval_all);
+				double r = rhs->eval_number(c, stack);
+
+				for (const xpath_node* li = ls.begin(); li != ls.end(); ++li)
+				{
+					xpath_allocator_capture cri(stack.result);
+
+					if (comp(convert_string_to_number(string_value(*li, stack.result).c_str()), r))
+						return true;
+				}
+
+				return false;
+			}
+			else
+			{
+				assert(false && "Wrong types"); // unreachable
+				return false;
+			}
+		}
+
+		static void apply_predicate_boolean(xpath_node_set_raw& ns, size_t first, xpath_ast_node* expr, const xpath_stack& stack, bool once)
+		{
+			assert(ns.size() >= first);
+			assert(expr->rettype() != xpath_type_number);
+
+			size_t i = 1;
+			size_t size = ns.size() - first;
+
+			xpath_node* last = ns.begin() + first;
+
+			// remove_if... or well, sort of
+			for (xpath_node* it = last; it != ns.end(); ++it, ++i)
+			{
+				xpath_context c(*it, i, size);
+
+				if (expr->eval_boolean(c, stack))
+				{
+					*last++ = *it;
+
+					if (once) break;
+				}
+			}
+
+			ns.truncate(last);
+		}
+
+		static void apply_predicate_number(xpath_node_set_raw& ns, size_t first, xpath_ast_node* expr, const xpath_stack& stack, bool once)
+		{
+			assert(ns.size() >= first);
+			assert(expr->rettype() == xpath_type_number);
+
+			size_t i = 1;
+			size_t size = ns.size() - first;
+
+			xpath_node* last = ns.begin() + first;
+
+			// remove_if... or well, sort of
+			for (xpath_node* it = last; it != ns.end(); ++it, ++i)
+			{
+				xpath_context c(*it, i, size);
+
+				if (expr->eval_number(c, stack) == static_cast<double>(i))
+				{
+					*last++ = *it;
+
+					if (once) break;
+				}
+			}
+
+			ns.truncate(last);
+		}
+
+		static void apply_predicate_number_const(xpath_node_set_raw& ns, size_t first, xpath_ast_node* expr, const xpath_stack& stack)
+		{
+			assert(ns.size() >= first);
+			assert(expr->rettype() == xpath_type_number);
+
+			size_t size = ns.size() - first;
+
+			xpath_node* last = ns.begin() + first;
+
+			xpath_node cn;
+			xpath_context c(cn, 1, size);
+
+			double er = expr->eval_number(c, stack);
+
+			if (er >= 1.0 && er <= static_cast<double>(size))
+			{
+				size_t eri = static_cast<size_t>(er);
+
+				if (er == static_cast<double>(eri))
+				{
+					xpath_node r = last[eri - 1];
+
+					*last++ = r;
+				}
+			}
+
+			ns.truncate(last);
+		}
+
+		void apply_predicate(xpath_node_set_raw& ns, size_t first, const xpath_stack& stack, bool once)
+		{
+			if (ns.size() == first) return;
+
+			assert(_type == ast_filter || _type == ast_predicate);
+
+			if (_test == predicate_constant || _test == predicate_constant_one)
+				apply_predicate_number_const(ns, first, _right, stack);
+			else if (_right->rettype() == xpath_type_number)
+				apply_predicate_number(ns, first, _right, stack, once);
+			else
+				apply_predicate_boolean(ns, first, _right, stack, once);
+		}
+
+		void apply_predicates(xpath_node_set_raw& ns, size_t first, const xpath_stack& stack, nodeset_eval_t eval)
+		{
+			if (ns.size() == first) return;
+
+			bool last_once = eval_once(ns.type(), eval);
+
+			for (xpath_ast_node* pred = _right; pred; pred = pred->_next)
+				pred->apply_predicate(ns, first, stack, !pred->_next && last_once);
+		}
+
+		bool step_push(xpath_node_set_raw& ns, xml_attribute_struct* a, xml_node_struct* parent, xpath_allocator* alloc)
+		{
+			assert(a);
+
+			const char_t* name = a->name ? a->name + 0 : PUGIXML_TEXT("");
+
+			switch (_test)
+			{
+			case nodetest_name:
+				if (strequal(name, _data.nodetest) && is_xpath_attribute(name))
+				{
+					ns.push_back(xpath_node(xml_attribute(a), xml_node(parent)), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_type_node:
+			case nodetest_all:
+				if (is_xpath_attribute(name))
+				{
+					ns.push_back(xpath_node(xml_attribute(a), xml_node(parent)), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_all_in_namespace:
+				if (starts_with(name, _data.nodetest) && is_xpath_attribute(name))
+				{
+					ns.push_back(xpath_node(xml_attribute(a), xml_node(parent)), alloc);
+					return true;
+				}
+				break;
+
+			default:
+				;
+			}
+
+			return false;
+		}
+
+		bool step_push(xpath_node_set_raw& ns, xml_node_struct* n, xpath_allocator* alloc)
+		{
+			assert(n);
+
+			xml_node_type type = PUGI_IMPL_NODETYPE(n);
+
+			switch (_test)
+			{
+			case nodetest_name:
+				if (type == node_element && n->name && strequal(n->name, _data.nodetest))
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_type_node:
+				ns.push_back(xml_node(n), alloc);
+				return true;
+
+			case nodetest_type_comment:
+				if (type == node_comment)
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_type_text:
+				if (type == node_pcdata || type == node_cdata)
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_type_pi:
+				if (type == node_pi)
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_pi:
+				if (type == node_pi && n->name && strequal(n->name, _data.nodetest))
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_all:
+				if (type == node_element)
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_all_in_namespace:
+				if (type == node_element && n->name && starts_with(n->name, _data.nodetest))
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			default:
+				assert(false && "Unknown axis"); // unreachable
+			}
+
+			return false;
+		}
+
+		template <class T> void step_fill(xpath_node_set_raw& ns, xml_node_struct* n, xpath_allocator* alloc, bool once, T)
+		{
+			const axis_t axis = T::axis;
+
+			switch (axis)
+			{
+			case axis_attribute:
+			{
+				for (xml_attribute_struct* a = n->first_attribute; a; a = a->next_attribute)
+					if (step_push(ns, a, n, alloc) & once)
+						return;
+
+				break;
+			}
+
+			case axis_child:
+			{
+				for (xml_node_struct* c = n->first_child; c; c = c->next_sibling)
+					if (step_push(ns, c, alloc) & once)
+						return;
+
+				break;
+			}
+
+			case axis_descendant:
+			case axis_descendant_or_self:
+			{
+				if (axis == axis_descendant_or_self)
+					if (step_push(ns, n, alloc) & once)
+						return;
+
+				xml_node_struct* cur = n->first_child;
+
+				while (cur)
+				{
+					if (step_push(ns, cur, alloc) & once)
+						return;
+
+					if (cur->first_child)
+						cur = cur->first_child;
+					else
+					{
+						while (!cur->next_sibling)
+						{
+							cur = cur->parent;
+
+							if (cur == n) return;
+						}
+
+						cur = cur->next_sibling;
+					}
+				}
+
+				break;
+			}
+
+			case axis_following_sibling:
+			{
+				for (xml_node_struct* c = n->next_sibling; c; c = c->next_sibling)
+					if (step_push(ns, c, alloc) & once)
+						return;
+
+				break;
+			}
+
+			case axis_preceding_sibling:
+			{
+				for (xml_node_struct* c = n->prev_sibling_c; c->next_sibling; c = c->prev_sibling_c)
+					if (step_push(ns, c, alloc) & once)
+						return;
+
+				break;
+			}
+
+			case axis_following:
+			{
+				xml_node_struct* cur = n;
+
+				// exit from this node so that we don't include descendants
+				while (!cur->next_sibling)
+				{
+					cur = cur->parent;
+
+					if (!cur) return;
+				}
+
+				cur = cur->next_sibling;
+
+				while (cur)
+				{
+					if (step_push(ns, cur, alloc) & once)
+						return;
+
+					if (cur->first_child)
+						cur = cur->first_child;
+					else
+					{
+						while (!cur->next_sibling)
+						{
+							cur = cur->parent;
+
+							if (!cur) return;
+						}
+
+						cur = cur->next_sibling;
+					}
+				}
+
+				break;
+			}
+
+			case axis_preceding:
+			{
+				xml_node_struct* cur = n;
+
+				// exit from this node so that we don't include descendants
+				while (!cur->prev_sibling_c->next_sibling)
+				{
+					cur = cur->parent;
+
+					if (!cur) return;
+				}
+
+				cur = cur->prev_sibling_c;
+
+				while (cur)
+				{
+					if (cur->first_child)
+						cur = cur->first_child->prev_sibling_c;
+					else
+					{
+						// leaf node, can't be ancestor
+						if (step_push(ns, cur, alloc) & once)
+							return;
+
+						while (!cur->prev_sibling_c->next_sibling)
+						{
+							cur = cur->parent;
+
+							if (!cur) return;
+
+							if (!node_is_ancestor(cur, n))
+								if (step_push(ns, cur, alloc) & once)
+									return;
+						}
+
+						cur = cur->prev_sibling_c;
+					}
+				}
+
+				break;
+			}
+
+			case axis_ancestor:
+			case axis_ancestor_or_self:
+			{
+				if (axis == axis_ancestor_or_self)
+					if (step_push(ns, n, alloc) & once)
+						return;
+
+				xml_node_struct* cur = n->parent;
+
+				while (cur)
+				{
+					if (step_push(ns, cur, alloc) & once)
+						return;
+
+					cur = cur->parent;
+				}
+
+				break;
+			}
+
+			case axis_self:
+			{
+				step_push(ns, n, alloc);
+
+				break;
+			}
+
+			case axis_parent:
+			{
+				if (n->parent)
+					step_push(ns, n->parent, alloc);
+
+				break;
+			}
+
+			default:
+				assert(false && "Unimplemented axis"); // unreachable
+			}
+		}
+
+		template <class T> void step_fill(xpath_node_set_raw& ns, xml_attribute_struct* a, xml_node_struct* p, xpath_allocator* alloc, bool once, T v)
+		{
+			const axis_t axis = T::axis;
+
+			switch (axis)
+			{
+			case axis_ancestor:
+			case axis_ancestor_or_self:
+			{
+				if (axis == axis_ancestor_or_self && _test == nodetest_type_node) // reject attributes based on principal node type test
+					if (step_push(ns, a, p, alloc) & once)
+						return;
+
+				xml_node_struct* cur = p;
+
+				while (cur)
+				{
+					if (step_push(ns, cur, alloc) & once)
+						return;
+
+					cur = cur->parent;
+				}
+
+				break;
+			}
+
+			case axis_descendant_or_self:
+			case axis_self:
+			{
+				if (_test == nodetest_type_node) // reject attributes based on principal node type test
+					step_push(ns, a, p, alloc);
+
+				break;
+			}
+
+			case axis_following:
+			{
+				xml_node_struct* cur = p;
+
+				while (cur)
+				{
+					if (cur->first_child)
+						cur = cur->first_child;
+					else
+					{
+						while (!cur->next_sibling)
+						{
+							cur = cur->parent;
+
+							if (!cur) return;
+						}
+
+						cur = cur->next_sibling;
+					}
+
+					if (step_push(ns, cur, alloc) & once)
+						return;
+				}
+
+				break;
+			}
+
+			case axis_parent:
+			{
+				step_push(ns, p, alloc);
+
+				break;
+			}
+
+			case axis_preceding:
+			{
+				// preceding:: axis does not include attribute nodes and attribute ancestors (they are the same as parent's ancestors), so we can reuse node preceding
+				step_fill(ns, p, alloc, once, v);
+				break;
+			}
+
+			default:
+				assert(false && "Unimplemented axis"); // unreachable
+			}
+		}
+
+		template <class T> void step_fill(xpath_node_set_raw& ns, const xpath_node& xn, xpath_allocator* alloc, bool once, T v)
+		{
+			const axis_t axis = T::axis;
+			const bool axis_has_attributes = (axis == axis_ancestor || axis == axis_ancestor_or_self || axis == axis_descendant_or_self || axis == axis_following || axis == axis_parent || axis == axis_preceding || axis == axis_self);
+
+			if (xn.node())
+				step_fill(ns, xn.node().internal_object(), alloc, once, v);
+			else if (axis_has_attributes && xn.attribute() && xn.parent())
+				step_fill(ns, xn.attribute().internal_object(), xn.parent().internal_object(), alloc, once, v);
+		}
+
+		template <class T> xpath_node_set_raw step_do(const xpath_context& c, const xpath_stack& stack, nodeset_eval_t eval, T v)
+		{
+			const axis_t axis = T::axis;
+			const bool axis_reverse = (axis == axis_ancestor || axis == axis_ancestor_or_self || axis == axis_preceding || axis == axis_preceding_sibling);
+			const xpath_node_set::type_t axis_type = axis_reverse ? xpath_node_set::type_sorted_reverse : xpath_node_set::type_sorted;
+
+			bool once =
+				(axis == axis_attribute && _test == nodetest_name) ||
+				(!_right && eval_once(axis_type, eval)) ||
+			    // coverity[mixed_enums]
+				(_right && !_right->_next && _right->_test == predicate_constant_one);
+
+			xpath_node_set_raw ns;
+			ns.set_type(axis_type);
+
+			if (_left)
+			{
+				xpath_node_set_raw s = _left->eval_node_set(c, stack, nodeset_eval_all);
+
+				// self axis preserves the original order
+				if (axis == axis_self) ns.set_type(s.type());
+
+				for (const xpath_node* it = s.begin(); it != s.end(); ++it)
+				{
+					size_t size = ns.size();
+
+					// in general, all axes generate elements in a particular order, but there is no order guarantee if axis is applied to two nodes
+					if (axis != axis_self && size != 0) ns.set_type(xpath_node_set::type_unsorted);
+
+					step_fill(ns, *it, stack.result, once, v);
+					if (_right) apply_predicates(ns, size, stack, eval);
+				}
+			}
+			else
+			{
+				step_fill(ns, c.n, stack.result, once, v);
+				if (_right) apply_predicates(ns, 0, stack, eval);
+			}
+
+			// child, attribute and self axes always generate unique set of nodes
+			// for other axis, if the set stayed sorted, it stayed unique because the traversal algorithms do not visit the same node twice
+			if (axis != axis_child && axis != axis_attribute && axis != axis_self && ns.type() == xpath_node_set::type_unsorted)
+				ns.remove_duplicates(stack.temp);
+
+			return ns;
+		}
+
+	public:
+		xpath_ast_node(ast_type_t type, xpath_value_type rettype_, const char_t* value):
+			_type(static_cast<char>(type)), _rettype(static_cast<char>(rettype_)), _axis(0), _test(0), _left(0), _right(0), _next(0)
+		{
+			assert(type == ast_string_constant);
+			_data.string = value;
+		}
+
+		xpath_ast_node(ast_type_t type, xpath_value_type rettype_, double value):
+			_type(static_cast<char>(type)), _rettype(static_cast<char>(rettype_)), _axis(0), _test(0), _left(0), _right(0), _next(0)
+		{
+			assert(type == ast_number_constant);
+			_data.number = value;
+		}
+
+		xpath_ast_node(ast_type_t type, xpath_value_type rettype_, xpath_variable* value):
+			_type(static_cast<char>(type)), _rettype(static_cast<char>(rettype_)), _axis(0), _test(0), _left(0), _right(0), _next(0)
+		{
+			assert(type == ast_variable);
+			_data.variable = value;
+		}
+
+		xpath_ast_node(ast_type_t type, xpath_value_type rettype_, xpath_ast_node* left = 0, xpath_ast_node* right = 0):
+			_type(static_cast<char>(type)), _rettype(static_cast<char>(rettype_)), _axis(0), _test(0), _left(left), _right(right), _next(0)
+		{
+		}
+
+		xpath_ast_node(ast_type_t type, xpath_ast_node* left, axis_t axis, nodetest_t test, const char_t* contents):
+			_type(static_cast<char>(type)), _rettype(xpath_type_node_set), _axis(static_cast<char>(axis)), _test(static_cast<char>(test)), _left(left), _right(0), _next(0)
+		{
+			assert(type == ast_step);
+			_data.nodetest = contents;
+		}
+
+		xpath_ast_node(ast_type_t type, xpath_ast_node* left, xpath_ast_node* right, predicate_t test):
+			_type(static_cast<char>(type)), _rettype(xpath_type_node_set), _axis(0), _test(static_cast<char>(test)), _left(left), _right(right), _next(0)
+		{
+			assert(type == ast_filter || type == ast_predicate);
+		}
+
+		void set_next(xpath_ast_node* value)
+		{
+			_next = value;
+		}
+
+		void set_right(xpath_ast_node* value)
+		{
+			_right = value;
+		}
+
+		bool eval_boolean(const xpath_context& c, const xpath_stack& stack)
+		{
+			switch (_type)
+			{
+			case ast_op_or:
+				return _left->eval_boolean(c, stack) || _right->eval_boolean(c, stack);
+
+			case ast_op_and:
+				return _left->eval_boolean(c, stack) && _right->eval_boolean(c, stack);
+
+			case ast_op_equal:
+				return compare_eq(_left, _right, c, stack, equal_to());
+
+			case ast_op_not_equal:
+				return compare_eq(_left, _right, c, stack, not_equal_to());
+
+			case ast_op_less:
+				return compare_rel(_left, _right, c, stack, less());
+
+			case ast_op_greater:
+				return compare_rel(_right, _left, c, stack, less());
+
+			case ast_op_less_or_equal:
+				return compare_rel(_left, _right, c, stack, less_equal());
+
+			case ast_op_greater_or_equal:
+				return compare_rel(_right, _left, c, stack, less_equal());
+
+			case ast_func_starts_with:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_string lr = _left->eval_string(c, stack);
+				xpath_string rr = _right->eval_string(c, stack);
+
+				return starts_with(lr.c_str(), rr.c_str());
+			}
+
+			case ast_func_contains:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_string lr = _left->eval_string(c, stack);
+				xpath_string rr = _right->eval_string(c, stack);
+
+				return find_substring(lr.c_str(), rr.c_str()) != 0;
+			}
+
+			case ast_func_boolean:
+				return _left->eval_boolean(c, stack);
+
+			case ast_func_not:
+				return !_left->eval_boolean(c, stack);
+
+			case ast_func_true:
+				return true;
+
+			case ast_func_false:
+				return false;
+
+			case ast_func_lang:
+			{
+				if (c.n.attribute()) return false;
+
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_string lang = _left->eval_string(c, stack);
+
+				for (xml_node n = c.n.node(); n; n = n.parent())
+				{
+					xml_attribute a = n.attribute(PUGIXML_TEXT("xml:lang"));
+
+					if (a)
+					{
+						const char_t* value = a.value();
+
+						// strnicmp / strncasecmp is not portable
+						for (const char_t* lit = lang.c_str(); *lit; ++lit)
+						{
+							if (tolower_ascii(*lit) != tolower_ascii(*value)) return false;
+							++value;
+						}
+
+						return *value == 0 || *value == '-';
+					}
+				}
+
+				return false;
+			}
+
+			case ast_opt_compare_attribute:
+			{
+				const char_t* value = (_right->_type == ast_string_constant) ? _right->_data.string : _right->_data.variable->get_string();
+
+				xml_attribute attr = c.n.node().attribute(_left->_data.nodetest);
+
+				return attr && strequal(attr.value(), value) && is_xpath_attribute(attr.name());
+			}
+
+			case ast_variable:
+			{
+				assert(_rettype == _data.variable->type());
+
+				if (_rettype == xpath_type_boolean)
+					return _data.variable->get_boolean();
+
+				// variable needs to be converted to the correct type, this is handled by the fallthrough block below
+				break;
+			}
+
+			default:
+				;
+			}
+
+			// none of the ast types that return the value directly matched, we need to perform type conversion
+			switch (_rettype)
+			{
+			case xpath_type_number:
+				return convert_number_to_boolean(eval_number(c, stack));
+
+			case xpath_type_string:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return !eval_string(c, stack).empty();
+			}
+
+			case xpath_type_node_set:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return !eval_node_set(c, stack, nodeset_eval_any).empty();
+			}
+
+			default:
+				assert(false && "Wrong expression for return type boolean"); // unreachable
+				return false;
+			}
+		}
+
+		double eval_number(const xpath_context& c, const xpath_stack& stack)
+		{
+			switch (_type)
+			{
+			case ast_op_add:
+				return _left->eval_number(c, stack) + _right->eval_number(c, stack);
+
+			case ast_op_subtract:
+				return _left->eval_number(c, stack) - _right->eval_number(c, stack);
+
+			case ast_op_multiply:
+				return _left->eval_number(c, stack) * _right->eval_number(c, stack);
+
+			case ast_op_divide:
+				return _left->eval_number(c, stack) / _right->eval_number(c, stack);
+
+			case ast_op_mod:
+				return fmod(_left->eval_number(c, stack), _right->eval_number(c, stack));
+
+			case ast_op_negate:
+				return -_left->eval_number(c, stack);
+
+			case ast_number_constant:
+				return _data.number;
+
+			case ast_func_last:
+				return static_cast<double>(c.size);
+
+			case ast_func_position:
+				return static_cast<double>(c.position);
+
+			case ast_func_count:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return static_cast<double>(_left->eval_node_set(c, stack, nodeset_eval_all).size());
+			}
+
+			case ast_func_string_length_0:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return static_cast<double>(string_value(c.n, stack.result).length());
+			}
+
+			case ast_func_string_length_1:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return static_cast<double>(_left->eval_string(c, stack).length());
+			}
+
+			case ast_func_number_0:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return convert_string_to_number(string_value(c.n, stack.result).c_str());
+			}
+
+			case ast_func_number_1:
+				return _left->eval_number(c, stack);
+
+			case ast_func_sum:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				double r = 0;
+
+				xpath_node_set_raw ns = _left->eval_node_set(c, stack, nodeset_eval_all);
+
+				for (const xpath_node* it = ns.begin(); it != ns.end(); ++it)
+				{
+					xpath_allocator_capture cri(stack.result);
+
+					r += convert_string_to_number(string_value(*it, stack.result).c_str());
+				}
+
+				return r;
+			}
+
+			case ast_func_floor:
+			{
+				double r = _left->eval_number(c, stack);
+
+				return r == r ? floor(r) : r;
+			}
+
+			case ast_func_ceiling:
+			{
+				double r = _left->eval_number(c, stack);
+
+				return r == r ? ceil(r) : r;
+			}
+
+			case ast_func_round:
+				return round_nearest_nzero(_left->eval_number(c, stack));
+
+			case ast_variable:
+			{
+				assert(_rettype == _data.variable->type());
+
+				if (_rettype == xpath_type_number)
+					return _data.variable->get_number();
+
+				// variable needs to be converted to the correct type, this is handled by the fallthrough block below
+				break;
+			}
+
+			default:
+				;
+			}
+
+			// none of the ast types that return the value directly matched, we need to perform type conversion
+			switch (_rettype)
+			{
+			case xpath_type_boolean:
+				return eval_boolean(c, stack) ? 1 : 0;
+
+			case xpath_type_string:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return convert_string_to_number(eval_string(c, stack).c_str());
+			}
+
+			case xpath_type_node_set:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return convert_string_to_number(eval_string(c, stack).c_str());
+			}
+
+			default:
+				assert(false && "Wrong expression for return type number"); // unreachable
+				return 0;
+			}
+		}
+
+		xpath_string eval_string_concat(const xpath_context& c, const xpath_stack& stack)
+		{
+			assert(_type == ast_func_concat);
+
+			xpath_allocator_capture ct(stack.temp);
+
+			// count the string number
+			size_t count = 1;
+			for (xpath_ast_node* nc = _right; nc; nc = nc->_next) count++;
+
+			// allocate a buffer for temporary string objects
+			xpath_string* buffer = static_cast<xpath_string*>(stack.temp->allocate(count * sizeof(xpath_string)));
+			if (!buffer) return xpath_string();
+
+			// evaluate all strings to temporary stack
+			xpath_stack swapped_stack = {stack.temp, stack.result};
+
+			buffer[0] = _left->eval_string(c, swapped_stack);
+
+			size_t pos = 1;
+			for (xpath_ast_node* n = _right; n; n = n->_next, ++pos) buffer[pos] = n->eval_string(c, swapped_stack);
+			assert(pos == count);
+
+			// get total length
+			size_t length = 0;
+			for (size_t i = 0; i < count; ++i) length += buffer[i].length();
+
+			// create final string
+			char_t* result = static_cast<char_t*>(stack.result->allocate((length + 1) * sizeof(char_t)));
+			if (!result) return xpath_string();
+
+			char_t* ri = result;
+
+			for (size_t j = 0; j < count; ++j)
+				for (const char_t* bi = buffer[j].c_str(); *bi; ++bi)
+					*ri++ = *bi;
+
+			*ri = 0;
+
+			return xpath_string::from_heap_preallocated(result, ri);
+		}
+
+		xpath_string eval_string(const xpath_context& c, const xpath_stack& stack)
+		{
+			switch (_type)
+			{
+			case ast_string_constant:
+				return xpath_string::from_const(_data.string);
+
+			case ast_func_local_name_0:
+			{
+				xpath_node na = c.n;
+
+				return xpath_string::from_const(local_name(na));
+			}
+
+			case ast_func_local_name_1:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ns = _left->eval_node_set(c, stack, nodeset_eval_first);
+				xpath_node na = ns.first();
+
+				return xpath_string::from_const(local_name(na));
+			}
+
+			case ast_func_name_0:
+			{
+				xpath_node na = c.n;
+
+				return xpath_string::from_const(qualified_name(na));
+			}
+
+			case ast_func_name_1:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ns = _left->eval_node_set(c, stack, nodeset_eval_first);
+				xpath_node na = ns.first();
+
+				return xpath_string::from_const(qualified_name(na));
+			}
+
+			case ast_func_namespace_uri_0:
+			{
+				xpath_node na = c.n;
+
+				return xpath_string::from_const(namespace_uri(na));
+			}
+
+			case ast_func_namespace_uri_1:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ns = _left->eval_node_set(c, stack, nodeset_eval_first);
+				xpath_node na = ns.first();
+
+				return xpath_string::from_const(namespace_uri(na));
+			}
+
+			case ast_func_string_0:
+				return string_value(c.n, stack.result);
+
+			case ast_func_string_1:
+				return _left->eval_string(c, stack);
+
+			case ast_func_concat:
+				return eval_string_concat(c, stack);
+
+			case ast_func_substring_before:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_string s = _left->eval_string(c, swapped_stack);
+				xpath_string p = _right->eval_string(c, swapped_stack);
+
+				const char_t* pos = find_substring(s.c_str(), p.c_str());
+
+				return pos ? xpath_string::from_heap(s.c_str(), pos, stack.result) : xpath_string();
+			}
+
+			case ast_func_substring_after:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_string s = _left->eval_string(c, swapped_stack);
+				xpath_string p = _right->eval_string(c, swapped_stack);
+
+				const char_t* pos = find_substring(s.c_str(), p.c_str());
+				if (!pos) return xpath_string();
+
+				const char_t* rbegin = pos + p.length();
+				const char_t* rend = s.c_str() + s.length();
+
+				return s.uses_heap() ? xpath_string::from_heap(rbegin, rend, stack.result) : xpath_string::from_const(rbegin);
+			}
+
+			case ast_func_substring_2:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_string s = _left->eval_string(c, swapped_stack);
+				size_t s_length = s.length();
+
+				double first = round_nearest(_right->eval_number(c, stack));
+
+				if (is_nan(first)) return xpath_string(); // NaN
+				else if (first >= static_cast<double>(s_length + 1)) return xpath_string();
+
+				size_t pos = first < 1 ? 1 : static_cast<size_t>(first);
+				assert(1 <= pos && pos <= s_length + 1);
+
+				const char_t* rbegin = s.c_str() + (pos - 1);
+				const char_t* rend = s.c_str() + s.length();
+
+				return s.uses_heap() ? xpath_string::from_heap(rbegin, rend, stack.result) : xpath_string::from_const(rbegin);
+			}
+
+			case ast_func_substring_3:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_string s = _left->eval_string(c, swapped_stack);
+				size_t s_length = s.length();
+
+				double first = round_nearest(_right->eval_number(c, stack));
+				double last = first + round_nearest(_right->_next->eval_number(c, stack));
+
+				if (is_nan(first) || is_nan(last)) return xpath_string();
+				else if (first >= static_cast<double>(s_length + 1)) return xpath_string();
+				else if (first >= last) return xpath_string();
+				else if (last < 1) return xpath_string();
+
+				size_t pos = first < 1 ? 1 : static_cast<size_t>(first);
+				size_t end = last >= static_cast<double>(s_length + 1) ? s_length + 1 : static_cast<size_t>(last);
+
+				assert(1 <= pos && pos <= end && end <= s_length + 1);
+				const char_t* rbegin = s.c_str() + (pos - 1);
+				const char_t* rend = s.c_str() + (end - 1);
+
+				return (end == s_length + 1 && !s.uses_heap()) ? xpath_string::from_const(rbegin) : xpath_string::from_heap(rbegin, rend, stack.result);
+			}
+
+			case ast_func_normalize_space_0:
+			{
+				xpath_string s = string_value(c.n, stack.result);
+
+				char_t* begin = s.data(stack.result);
+				if (!begin) return xpath_string();
+
+				char_t* end = normalize_space(begin);
+
+				return xpath_string::from_heap_preallocated(begin, end);
+			}
+
+			case ast_func_normalize_space_1:
+			{
+				xpath_string s = _left->eval_string(c, stack);
+
+				char_t* begin = s.data(stack.result);
+				if (!begin) return xpath_string();
+
+				char_t* end = normalize_space(begin);
+
+				return xpath_string::from_heap_preallocated(begin, end);
+			}
+
+			case ast_func_translate:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_string s = _left->eval_string(c, stack);
+				xpath_string from = _right->eval_string(c, swapped_stack);
+				xpath_string to = _right->_next->eval_string(c, swapped_stack);
+
+				char_t* begin = s.data(stack.result);
+				if (!begin) return xpath_string();
+
+				char_t* end = translate(begin, from.c_str(), to.c_str(), to.length());
+
+				return xpath_string::from_heap_preallocated(begin, end);
+			}
+
+			case ast_opt_translate_table:
+			{
+				xpath_string s = _left->eval_string(c, stack);
+
+				char_t* begin = s.data(stack.result);
+				if (!begin) return xpath_string();
+
+				char_t* end = translate_table(begin, _data.table);
+
+				return xpath_string::from_heap_preallocated(begin, end);
+			}
+
+			case ast_variable:
+			{
+				assert(_rettype == _data.variable->type());
+
+				if (_rettype == xpath_type_string)
+					return xpath_string::from_const(_data.variable->get_string());
+
+				// variable needs to be converted to the correct type, this is handled by the fallthrough block below
+				break;
+			}
+
+			default:
+				;
+			}
+
+			// none of the ast types that return the value directly matched, we need to perform type conversion
+			switch (_rettype)
+			{
+			case xpath_type_boolean:
+				return xpath_string::from_const(eval_boolean(c, stack) ? PUGIXML_TEXT("true") : PUGIXML_TEXT("false"));
+
+			case xpath_type_number:
+				return convert_number_to_string(eval_number(c, stack), stack.result);
+
+			case xpath_type_node_set:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_node_set_raw ns = eval_node_set(c, swapped_stack, nodeset_eval_first);
+				return ns.empty() ? xpath_string() : string_value(ns.first(), stack.result);
+			}
+
+			default:
+				assert(false && "Wrong expression for return type string"); // unreachable
+				return xpath_string();
+			}
+		}
+
+		xpath_node_set_raw eval_node_set(const xpath_context& c, const xpath_stack& stack, nodeset_eval_t eval)
+		{
+			switch (_type)
+			{
+			case ast_op_union:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_node_set_raw ls = _left->eval_node_set(c, stack, eval);
+				xpath_node_set_raw rs = _right->eval_node_set(c, swapped_stack, eval);
+
+				// we can optimize merging two sorted sets, but this is a very rare operation, so don't bother
+				ls.set_type(xpath_node_set::type_unsorted);
+
+				ls.append(rs.begin(), rs.end(), stack.result);
+				ls.remove_duplicates(stack.temp);
+
+				return ls;
+			}
+
+			case ast_filter:
+			{
+				xpath_node_set_raw set = _left->eval_node_set(c, stack, _test == predicate_constant_one ? nodeset_eval_first : nodeset_eval_all);
+
+				// either expression is a number or it contains position() call; sort by document order
+				if (_test != predicate_posinv) set.sort_do();
+
+				bool once = eval_once(set.type(), eval);
+
+				apply_predicate(set, 0, stack, once);
+
+				return set;
+			}
+
+			case ast_func_id:
+				return xpath_node_set_raw();
+
+			case ast_step:
+			{
+				switch (_axis)
+				{
+				case axis_ancestor:
+					return step_do(c, stack, eval, axis_to_type<axis_ancestor>());
+
+				case axis_ancestor_or_self:
+					return step_do(c, stack, eval, axis_to_type<axis_ancestor_or_self>());
+
+				case axis_attribute:
+					return step_do(c, stack, eval, axis_to_type<axis_attribute>());
+
+				case axis_child:
+					return step_do(c, stack, eval, axis_to_type<axis_child>());
+
+				case axis_descendant:
+					return step_do(c, stack, eval, axis_to_type<axis_descendant>());
+
+				case axis_descendant_or_self:
+					return step_do(c, stack, eval, axis_to_type<axis_descendant_or_self>());
+
+				case axis_following:
+					return step_do(c, stack, eval, axis_to_type<axis_following>());
+
+				case axis_following_sibling:
+					return step_do(c, stack, eval, axis_to_type<axis_following_sibling>());
+
+				case axis_namespace:
+					// namespaced axis is not supported
+					return xpath_node_set_raw();
+
+				case axis_parent:
+					return step_do(c, stack, eval, axis_to_type<axis_parent>());
+
+				case axis_preceding:
+					return step_do(c, stack, eval, axis_to_type<axis_preceding>());
+
+				case axis_preceding_sibling:
+					return step_do(c, stack, eval, axis_to_type<axis_preceding_sibling>());
+
+				case axis_self:
+					return step_do(c, stack, eval, axis_to_type<axis_self>());
+
+				default:
+					assert(false && "Unknown axis"); // unreachable
+					return xpath_node_set_raw();
+				}
+			}
+
+			case ast_step_root:
+			{
+				assert(!_right); // root step can't have any predicates
+
+				xpath_node_set_raw ns;
+
+				ns.set_type(xpath_node_set::type_sorted);
+
+				if (c.n.node()) ns.push_back(c.n.node().root(), stack.result);
+				else if (c.n.attribute()) ns.push_back(c.n.parent().root(), stack.result);
+
+				return ns;
+			}
+
+			case ast_variable:
+			{
+				assert(_rettype == _data.variable->type());
+
+				if (_rettype == xpath_type_node_set)
+				{
+					const xpath_node_set& s = _data.variable->get_node_set();
+
+					xpath_node_set_raw ns;
+
+					ns.set_type(s.type());
+					ns.append(s.begin(), s.end(), stack.result);
+
+					return ns;
+				}
+
+				// variable needs to be converted to the correct type, this is handled by the fallthrough block below
+				break;
+			}
+
+			default:
+				;
+			}
+
+			// none of the ast types that return the value directly matched, but conversions to node set are invalid
+			assert(false && "Wrong expression for return type node set"); // unreachable
+			return xpath_node_set_raw();
+		}
+
+		void optimize(xpath_allocator* alloc)
+		{
+			if (_left)
+				_left->optimize(alloc);
+
+			if (_right)
+				_right->optimize(alloc);
+
+			if (_next)
+				_next->optimize(alloc);
+
+			// coverity[var_deref_model]
+			optimize_self(alloc);
+		}
+
+		void optimize_self(xpath_allocator* alloc)
+		{
+			// Rewrite [position()=expr] with [expr]
+			// Note that this step has to go before classification to recognize [position()=1]
+			if ((_type == ast_filter || _type == ast_predicate) &&
+				_right && // workaround for clang static analyzer (_right is never null for ast_filter/ast_predicate)
+				_right->_type == ast_op_equal && _right->_left->_type == ast_func_position && _right->_right->_rettype == xpath_type_number)
+			{
+				_right = _right->_right;
+			}
+
+			// Classify filter/predicate ops to perform various optimizations during evaluation
+			if ((_type == ast_filter || _type == ast_predicate) && _right) // workaround for clang static analyzer (_right is never null for ast_filter/ast_predicate)
+			{
+				assert(_test == predicate_default);
+
+				if (_right->_type == ast_number_constant && _right->_data.number == 1.0)
+					_test = predicate_constant_one;
+				else if (_right->_rettype == xpath_type_number && (_right->_type == ast_number_constant || _right->_type == ast_variable || _right->_type == ast_func_last))
+					_test = predicate_constant;
+				else if (_right->_rettype != xpath_type_number && _right->is_posinv_expr())
+					_test = predicate_posinv;
+			}
+
+			// Rewrite descendant-or-self::node()/child::foo with descendant::foo
+			// The former is a full form of //foo, the latter is much faster since it executes the node test immediately
+			// Do a similar kind of rewrite for self/descendant/descendant-or-self axes
+			// Note that we only rewrite positionally invariant steps (//foo[1] != /descendant::foo[1])
+			if (_type == ast_step && (_axis == axis_child || _axis == axis_self || _axis == axis_descendant || _axis == axis_descendant_or_self) &&
+				_left && _left->_type == ast_step && _left->_axis == axis_descendant_or_self && _left->_test == nodetest_type_node && !_left->_right &&
+				is_posinv_step())
+			{
+				if (_axis == axis_child || _axis == axis_descendant)
+					_axis = axis_descendant;
+				else
+					_axis = axis_descendant_or_self;
+
+				_left = _left->_left;
+			}
+
+			// Use optimized lookup table implementation for translate() with constant arguments
+			if (_type == ast_func_translate &&
+				_right && // workaround for clang static analyzer (_right is never null for ast_func_translate)
+				_right->_type == ast_string_constant && _right->_next->_type == ast_string_constant)
+			{
+				unsigned char* table = translate_table_generate(alloc, _right->_data.string, _right->_next->_data.string);
+
+				if (table)
+				{
+					_type = ast_opt_translate_table;
+					_data.table = table;
+				}
+			}
+
+			// Use optimized path for @attr = 'value' or @attr = $value
+			if (_type == ast_op_equal &&
+				_left && _right && // workaround for clang static analyzer and Coverity (_left and _right are never null for ast_op_equal)
+                // coverity[mixed_enums]
+				_left->_type == ast_step && _left->_axis == axis_attribute && _left->_test == nodetest_name && !_left->_left && !_left->_right &&
+				(_right->_type == ast_string_constant || (_right->_type == ast_variable && _right->_rettype == xpath_type_string)))
+			{
+				_type = ast_opt_compare_attribute;
+			}
+		}
+
+		bool is_posinv_expr() const
+		{
+			switch (_type)
+			{
+			case ast_func_position:
+			case ast_func_last:
+				return false;
+
+			case ast_string_constant:
+			case ast_number_constant:
+			case ast_variable:
+				return true;
+
+			case ast_step:
+			case ast_step_root:
+				return true;
+
+			case ast_predicate:
+			case ast_filter:
+				return true;
+
+			default:
+				if (_left && !_left->is_posinv_expr()) return false;
+
+				for (xpath_ast_node* n = _right; n; n = n->_next)
+					if (!n->is_posinv_expr()) return false;
+
+				return true;
+			}
+		}
+
+		bool is_posinv_step() const
+		{
+			assert(_type == ast_step);
+
+			for (xpath_ast_node* n = _right; n; n = n->_next)
+			{
+				assert(n->_type == ast_predicate);
+
+				if (n->_test != predicate_posinv)
+					return false;
+			}
+
+			return true;
+		}
+
+		xpath_value_type rettype() const
+		{
+			return static_cast<xpath_value_type>(_rettype);
+		}
+	};
+
+	static const size_t xpath_ast_depth_limit =
+	#ifdef PUGIXML_XPATH_DEPTH_LIMIT
+		PUGIXML_XPATH_DEPTH_LIMIT
+	#else
+		1024
+	#endif
+		;
+
+	struct xpath_parser
+	{
+		xpath_allocator* _alloc;
+		xpath_lexer _lexer;
+
+		const char_t* _query;
+		xpath_variable_set* _variables;
+
+		xpath_parse_result* _result;
+
+		char_t _scratch[32];
+
+		size_t _depth;
+
+		xpath_ast_node* error(const char* message)
+		{
+			_result->error = message;
+			_result->offset = _lexer.current_pos() - _query;
+
+			return 0;
+		}
+
+		xpath_ast_node* error_oom()
+		{
+			assert(_alloc->_error);
+			*_alloc->_error = true;
+
+			return 0;
+		}
+
+		xpath_ast_node* error_rec()
+		{
+			return error("Exceeded maximum allowed query depth");
+		}
+
+		void* alloc_node()
+		{
+			return _alloc->allocate(sizeof(xpath_ast_node));
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_value_type rettype, const char_t* value)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, rettype, value) : 0;
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_value_type rettype, double value)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, rettype, value) : 0;
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_value_type rettype, xpath_variable* value)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, rettype, value) : 0;
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_value_type rettype, xpath_ast_node* left = 0, xpath_ast_node* right = 0)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, rettype, left, right) : 0;
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_ast_node* left, axis_t axis, nodetest_t test, const char_t* contents)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, left, axis, test, contents) : 0;
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_ast_node* left, xpath_ast_node* right, predicate_t test)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, left, right, test) : 0;
+		}
+
+		const char_t* alloc_string(const xpath_lexer_string& value)
+		{
+			if (!value.begin)
+				return PUGIXML_TEXT("");
+
+			size_t length = static_cast<size_t>(value.end - value.begin);
+
+			char_t* c = static_cast<char_t*>(_alloc->allocate((length + 1) * sizeof(char_t)));
+			if (!c) return 0;
+
+			memcpy(c, value.begin, length * sizeof(char_t));
+			c[length] = 0;
+
+			return c;
+		}
+
+		xpath_ast_node* parse_function(const xpath_lexer_string& name, size_t argc, xpath_ast_node* args[2])
+		{
+			switch (name.begin[0])
+			{
+			case 'b':
+				if (name == PUGIXML_TEXT("boolean") && argc == 1)
+					return alloc_node(ast_func_boolean, xpath_type_boolean, args[0]);
+
+				break;
+
+			case 'c':
+				if (name == PUGIXML_TEXT("count") && argc == 1)
+				{
+					if (args[0]->rettype() != xpath_type_node_set) return error("Function has to be applied to node set");
+					return alloc_node(ast_func_count, xpath_type_number, args[0]);
+				}
+				else if (name == PUGIXML_TEXT("contains") && argc == 2)
+					return alloc_node(ast_func_contains, xpath_type_boolean, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("concat") && argc >= 2)
+					return alloc_node(ast_func_concat, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("ceiling") && argc == 1)
+					return alloc_node(ast_func_ceiling, xpath_type_number, args[0]);
+
+				break;
+
+			case 'f':
+				if (name == PUGIXML_TEXT("false") && argc == 0)
+					return alloc_node(ast_func_false, xpath_type_boolean);
+				else if (name == PUGIXML_TEXT("floor") && argc == 1)
+					return alloc_node(ast_func_floor, xpath_type_number, args[0]);
+
+				break;
+
+			case 'i':
+				if (name == PUGIXML_TEXT("id") && argc == 1)
+					return alloc_node(ast_func_id, xpath_type_node_set, args[0]);
+
+				break;
+
+			case 'l':
+				if (name == PUGIXML_TEXT("last") && argc == 0)
+					return alloc_node(ast_func_last, xpath_type_number);
+				else if (name == PUGIXML_TEXT("lang") && argc == 1)
+					return alloc_node(ast_func_lang, xpath_type_boolean, args[0]);
+				else if (name == PUGIXML_TEXT("local-name") && argc <= 1)
+				{
+					if (argc == 1 && args[0]->rettype() != xpath_type_node_set) return error("Function has to be applied to node set");
+					return alloc_node(argc == 0 ? ast_func_local_name_0 : ast_func_local_name_1, xpath_type_string, args[0]);
+				}
+
+				break;
+
+			case 'n':
+				if (name == PUGIXML_TEXT("name") && argc <= 1)
+				{
+					if (argc == 1 && args[0]->rettype() != xpath_type_node_set) return error("Function has to be applied to node set");
+					return alloc_node(argc == 0 ? ast_func_name_0 : ast_func_name_1, xpath_type_string, args[0]);
+				}
+				else if (name == PUGIXML_TEXT("namespace-uri") && argc <= 1)
+				{
+					if (argc == 1 && args[0]->rettype() != xpath_type_node_set) return error("Function has to be applied to node set");
+					return alloc_node(argc == 0 ? ast_func_namespace_uri_0 : ast_func_namespace_uri_1, xpath_type_string, args[0]);
+				}
+				else if (name == PUGIXML_TEXT("normalize-space") && argc <= 1)
+					return alloc_node(argc == 0 ? ast_func_normalize_space_0 : ast_func_normalize_space_1, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("not") && argc == 1)
+					return alloc_node(ast_func_not, xpath_type_boolean, args[0]);
+				else if (name == PUGIXML_TEXT("number") && argc <= 1)
+					return alloc_node(argc == 0 ? ast_func_number_0 : ast_func_number_1, xpath_type_number, args[0]);
+
+				break;
+
+			case 'p':
+				if (name == PUGIXML_TEXT("position") && argc == 0)
+					return alloc_node(ast_func_position, xpath_type_number);
+
+				break;
+
+			case 'r':
+				if (name == PUGIXML_TEXT("round") && argc == 1)
+					return alloc_node(ast_func_round, xpath_type_number, args[0]);
+
+				break;
+
+			case 's':
+				if (name == PUGIXML_TEXT("string") && argc <= 1)
+					return alloc_node(argc == 0 ? ast_func_string_0 : ast_func_string_1, xpath_type_string, args[0]);
+				else if (name == PUGIXML_TEXT("string-length") && argc <= 1)
+					return alloc_node(argc == 0 ? ast_func_string_length_0 : ast_func_string_length_1, xpath_type_number, args[0]);
+				else if (name == PUGIXML_TEXT("starts-with") && argc == 2)
+					return alloc_node(ast_func_starts_with, xpath_type_boolean, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("substring-before") && argc == 2)
+					return alloc_node(ast_func_substring_before, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("substring-after") && argc == 2)
+					return alloc_node(ast_func_substring_after, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("substring") && (argc == 2 || argc == 3))
+					return alloc_node(argc == 2 ? ast_func_substring_2 : ast_func_substring_3, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("sum") && argc == 1)
+				{
+					if (args[0]->rettype() != xpath_type_node_set) return error("Function has to be applied to node set");
+					return alloc_node(ast_func_sum, xpath_type_number, args[0]);
+				}
+
+				break;
+
+			case 't':
+				if (name == PUGIXML_TEXT("translate") && argc == 3)
+					return alloc_node(ast_func_translate, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("true") && argc == 0)
+					return alloc_node(ast_func_true, xpath_type_boolean);
+
+				break;
+
+			default:
+				break;
+			}
+
+			return error("Unrecognized function or wrong parameter count");
+		}
+
+		axis_t parse_axis_name(const xpath_lexer_string& name, bool& specified)
+		{
+			specified = true;
+
+			switch (name.begin[0])
+			{
+			case 'a':
+				if (name == PUGIXML_TEXT("ancestor"))
+					return axis_ancestor;
+				else if (name == PUGIXML_TEXT("ancestor-or-self"))
+					return axis_ancestor_or_self;
+				else if (name == PUGIXML_TEXT("attribute"))
+					return axis_attribute;
+
+				break;
+
+			case 'c':
+				if (name == PUGIXML_TEXT("child"))
+					return axis_child;
+
+				break;
+
+			case 'd':
+				if (name == PUGIXML_TEXT("descendant"))
+					return axis_descendant;
+				else if (name == PUGIXML_TEXT("descendant-or-self"))
+					return axis_descendant_or_self;
+
+				break;
+
+			case 'f':
+				if (name == PUGIXML_TEXT("following"))
+					return axis_following;
+				else if (name == PUGIXML_TEXT("following-sibling"))
+					return axis_following_sibling;
+
+				break;
+
+			case 'n':
+				if (name == PUGIXML_TEXT("namespace"))
+					return axis_namespace;
+
+				break;
+
+			case 'p':
+				if (name == PUGIXML_TEXT("parent"))
+					return axis_parent;
+				else if (name == PUGIXML_TEXT("preceding"))
+					return axis_preceding;
+				else if (name == PUGIXML_TEXT("preceding-sibling"))
+					return axis_preceding_sibling;
+
+				break;
+
+			case 's':
+				if (name == PUGIXML_TEXT("self"))
+					return axis_self;
+
+				break;
+
+			default:
+				break;
+			}
+
+			specified = false;
+			return axis_child;
+		}
+
+		nodetest_t parse_node_test_type(const xpath_lexer_string& name)
+		{
+			switch (name.begin[0])
+			{
+			case 'c':
+				if (name == PUGIXML_TEXT("comment"))
+					return nodetest_type_comment;
+
+				break;
+
+			case 'n':
+				if (name == PUGIXML_TEXT("node"))
+					return nodetest_type_node;
+
+				break;
+
+			case 'p':
+				if (name == PUGIXML_TEXT("processing-instruction"))
+					return nodetest_type_pi;
+
+				break;
+
+			case 't':
+				if (name == PUGIXML_TEXT("text"))
+					return nodetest_type_text;
+
+				break;
+
+			default:
+				break;
+			}
+
+			return nodetest_none;
+		}
+
+		// PrimaryExpr ::= VariableReference | '(' Expr ')' | Literal | Number | FunctionCall
+		xpath_ast_node* parse_primary_expression()
+		{
+			switch (_lexer.current())
+			{
+			case lex_var_ref:
+			{
+				xpath_lexer_string name = _lexer.contents();
+
+				if (!_variables)
+					return error("Unknown variable: variable set is not provided");
+
+				xpath_variable* var = 0;
+				if (!get_variable_scratch(_scratch, _variables, name.begin, name.end, &var))
+					return error_oom();
+
+				if (!var)
+					return error("Unknown variable: variable set does not contain the given name");
+
+				_lexer.next();
+
+				return alloc_node(ast_variable, var->type(), var);
+			}
+
+			case lex_open_brace:
+			{
+				_lexer.next();
+
+				xpath_ast_node* n = parse_expression();
+				if (!n) return 0;
+
+				if (_lexer.current() != lex_close_brace)
+					return error("Expected ')' to match an opening '('");
+
+				_lexer.next();
+
+				return n;
+			}
+
+			case lex_quoted_string:
+			{
+				const char_t* value = alloc_string(_lexer.contents());
+				if (!value) return 0;
+
+				_lexer.next();
+
+				return alloc_node(ast_string_constant, xpath_type_string, value);
+			}
+
+			case lex_number:
+			{
+				double value = 0;
+
+				if (!convert_string_to_number_scratch(_scratch, _lexer.contents().begin, _lexer.contents().end, &value))
+					return error_oom();
+
+				_lexer.next();
+
+				return alloc_node(ast_number_constant, xpath_type_number, value);
+			}
+
+			case lex_string:
+			{
+				xpath_ast_node* args[2] = {0};
+				size_t argc = 0;
+
+				xpath_lexer_string function = _lexer.contents();
+				_lexer.next();
+
+				xpath_ast_node* last_arg = 0;
+
+				if (_lexer.current() != lex_open_brace)
+					return error("Unrecognized function call");
+				_lexer.next();
+
+				size_t old_depth = _depth;
+
+				while (_lexer.current() != lex_close_brace)
+				{
+					if (argc > 0)
+					{
+						if (_lexer.current() != lex_comma)
+							return error("No comma between function arguments");
+						_lexer.next();
+					}
+
+					if (++_depth > xpath_ast_depth_limit)
+						return error_rec();
+
+					xpath_ast_node* n = parse_expression();
+					if (!n) return 0;
+
+					if (argc < 2) args[argc] = n;
+					else last_arg->set_next(n);
+
+					argc++;
+					last_arg = n;
+				}
+
+				_lexer.next();
+
+				_depth = old_depth;
+
+				return parse_function(function, argc, args);
+			}
+
+			default:
+				return error("Unrecognizable primary expression");
+			}
+		}
+
+		// FilterExpr ::= PrimaryExpr | FilterExpr Predicate
+		// Predicate ::= '[' PredicateExpr ']'
+		// PredicateExpr ::= Expr
+		xpath_ast_node* parse_filter_expression()
+		{
+			xpath_ast_node* n = parse_primary_expression();
+			if (!n) return 0;
+
+			size_t old_depth = _depth;
+
+			while (_lexer.current() == lex_open_square_brace)
+			{
+				_lexer.next();
+
+				if (++_depth > xpath_ast_depth_limit)
+					return error_rec();
+
+				if (n->rettype() != xpath_type_node_set)
+					return error("Predicate has to be applied to node set");
+
+				xpath_ast_node* expr = parse_expression();
+				if (!expr) return 0;
+
+				n = alloc_node(ast_filter, n, expr, predicate_default);
+				if (!n) return 0;
+
+				if (_lexer.current() != lex_close_square_brace)
+					return error("Expected ']' to match an opening '['");
+
+				_lexer.next();
+			}
+
+			_depth = old_depth;
+
+			return n;
+		}
+
+		// Step ::= AxisSpecifier NodeTest Predicate* | AbbreviatedStep
+		// AxisSpecifier ::= AxisName '::' | '@'?
+		// NodeTest ::= NameTest | NodeType '(' ')' | 'processing-instruction' '(' Literal ')'
+		// NameTest ::= '*' | NCName ':' '*' | QName
+		// AbbreviatedStep ::= '.' | '..'
+		xpath_ast_node* parse_step(xpath_ast_node* set)
+		{
+			if (set && set->rettype() != xpath_type_node_set)
+				return error("Step has to be applied to node set");
+
+			bool axis_specified = false;
+			axis_t axis = axis_child; // implied child axis
+
+			if (_lexer.current() == lex_axis_attribute)
+			{
+				axis = axis_attribute;
+				axis_specified = true;
+
+				_lexer.next();
+			}
+			else if (_lexer.current() == lex_dot)
+			{
+				_lexer.next();
+
+				if (_lexer.current() == lex_open_square_brace)
+					return error("Predicates are not allowed after an abbreviated step");
+
+				return alloc_node(ast_step, set, axis_self, nodetest_type_node, 0);
+			}
+			else if (_lexer.current() == lex_double_dot)
+			{
+				_lexer.next();
+
+				if (_lexer.current() == lex_open_square_brace)
+					return error("Predicates are not allowed after an abbreviated step");
+
+				return alloc_node(ast_step, set, axis_parent, nodetest_type_node, 0);
+			}
+
+			nodetest_t nt_type = nodetest_none;
+			xpath_lexer_string nt_name;
+
+			if (_lexer.current() == lex_string)
+			{
+				// node name test
+				nt_name = _lexer.contents();
+				_lexer.next();
+
+				// was it an axis name?
+				if (_lexer.current() == lex_double_colon)
+				{
+					// parse axis name
+					if (axis_specified)
+						return error("Two axis specifiers in one step");
+
+					axis = parse_axis_name(nt_name, axis_specified);
+
+					if (!axis_specified)
+						return error("Unknown axis");
+
+					// read actual node test
+					_lexer.next();
+
+					if (_lexer.current() == lex_multiply)
+					{
+						nt_type = nodetest_all;
+						nt_name = xpath_lexer_string();
+						_lexer.next();
+					}
+					else if (_lexer.current() == lex_string)
+					{
+						nt_name = _lexer.contents();
+						_lexer.next();
+					}
+					else
+					{
+						return error("Unrecognized node test");
+					}
+				}
+
+				if (nt_type == nodetest_none)
+				{
+					// node type test or processing-instruction
+					if (_lexer.current() == lex_open_brace)
+					{
+						_lexer.next();
+
+						if (_lexer.current() == lex_close_brace)
+						{
+							_lexer.next();
+
+							nt_type = parse_node_test_type(nt_name);
+
+							if (nt_type == nodetest_none)
+								return error("Unrecognized node type");
+
+							nt_name = xpath_lexer_string();
+						}
+						else if (nt_name == PUGIXML_TEXT("processing-instruction"))
+						{
+							if (_lexer.current() != lex_quoted_string)
+								return error("Only literals are allowed as arguments to processing-instruction()");
+
+							nt_type = nodetest_pi;
+							nt_name = _lexer.contents();
+							_lexer.next();
+
+							if (_lexer.current() != lex_close_brace)
+								return error("Unmatched brace near processing-instruction()");
+							_lexer.next();
+						}
+						else
+						{
+							return error("Unmatched brace near node type test");
+						}
+					}
+					// QName or NCName:*
+					else
+					{
+						if (nt_name.end - nt_name.begin > 2 && nt_name.end[-2] == ':' && nt_name.end[-1] == '*') // NCName:*
+						{
+							nt_name.end--; // erase *
+
+							nt_type = nodetest_all_in_namespace;
+						}
+						else
+						{
+							nt_type = nodetest_name;
+						}
+					}
+				}
+			}
+			else if (_lexer.current() == lex_multiply)
+			{
+				nt_type = nodetest_all;
+				_lexer.next();
+			}
+			else
+			{
+				return error("Unrecognized node test");
+			}
+
+			const char_t* nt_name_copy = alloc_string(nt_name);
+			if (!nt_name_copy) return 0;
+
+			xpath_ast_node* n = alloc_node(ast_step, set, axis, nt_type, nt_name_copy);
+			if (!n) return 0;
+
+			size_t old_depth = _depth;
+
+			xpath_ast_node* last = 0;
+
+			while (_lexer.current() == lex_open_square_brace)
+			{
+				_lexer.next();
+
+				if (++_depth > xpath_ast_depth_limit)
+					return error_rec();
+
+				xpath_ast_node* expr = parse_expression();
+				if (!expr) return 0;
+
+				xpath_ast_node* pred = alloc_node(ast_predicate, 0, expr, predicate_default);
+				if (!pred) return 0;
+
+				if (_lexer.current() != lex_close_square_brace)
+					return error("Expected ']' to match an opening '['");
+				_lexer.next();
+
+				if (last) last->set_next(pred);
+				else n->set_right(pred);
+
+				last = pred;
+			}
+
+			_depth = old_depth;
+
+			return n;
+		}
+
+		// RelativeLocationPath ::= Step | RelativeLocationPath '/' Step | RelativeLocationPath '//' Step
+		xpath_ast_node* parse_relative_location_path(xpath_ast_node* set)
+		{
+			xpath_ast_node* n = parse_step(set);
+			if (!n) return 0;
+
+			size_t old_depth = _depth;
+
+			while (_lexer.current() == lex_slash || _lexer.current() == lex_double_slash)
+			{
+				lexeme_t l = _lexer.current();
+				_lexer.next();
+
+				if (l == lex_double_slash)
+				{
+					n = alloc_node(ast_step, n, axis_descendant_or_self, nodetest_type_node, 0);
+					if (!n) return 0;
+
+					++_depth;
+				}
+
+				if (++_depth > xpath_ast_depth_limit)
+					return error_rec();
+
+				n = parse_step(n);
+				if (!n) return 0;
+			}
+
+			_depth = old_depth;
+
+			return n;
+		}
+
+		// LocationPath ::= RelativeLocationPath | AbsoluteLocationPath
+		// AbsoluteLocationPath ::= '/' RelativeLocationPath? | '//' RelativeLocationPath
+		xpath_ast_node* parse_location_path()
+		{
+			if (_lexer.current() == lex_slash)
+			{
+				_lexer.next();
+
+				xpath_ast_node* n = alloc_node(ast_step_root, xpath_type_node_set);
+				if (!n) return 0;
+
+				// relative location path can start from axis_attribute, dot, double_dot, multiply and string lexemes; any other lexeme means standalone root path
+				lexeme_t l = _lexer.current();
+
+				if (l == lex_string || l == lex_axis_attribute || l == lex_dot || l == lex_double_dot || l == lex_multiply)
+					return parse_relative_location_path(n);
+				else
+					return n;
+			}
+			else if (_lexer.current() == lex_double_slash)
+			{
+				_lexer.next();
+
+				xpath_ast_node* n = alloc_node(ast_step_root, xpath_type_node_set);
+				if (!n) return 0;
+
+				n = alloc_node(ast_step, n, axis_descendant_or_self, nodetest_type_node, 0);
+				if (!n) return 0;
+
+				return parse_relative_location_path(n);
+			}
+
+			// else clause moved outside of if because of bogus warning 'control may reach end of non-void function being inlined' in gcc 4.0.1
+			return parse_relative_location_path(0);
+		}
+
+		// PathExpr ::= LocationPath
+		//				| FilterExpr
+		//				| FilterExpr '/' RelativeLocationPath
+		//				| FilterExpr '//' RelativeLocationPath
+		// UnionExpr ::= PathExpr | UnionExpr '|' PathExpr
+		// UnaryExpr ::= UnionExpr | '-' UnaryExpr
+		xpath_ast_node* parse_path_or_unary_expression()
+		{
+			// Clarification.
+			// PathExpr begins with either LocationPath or FilterExpr.
+			// FilterExpr begins with PrimaryExpr
+			// PrimaryExpr begins with '$' in case of it being a variable reference,
+			// '(' in case of it being an expression, string literal, number constant or
+			// function call.
+			if (_lexer.current() == lex_var_ref || _lexer.current() == lex_open_brace ||
+				_lexer.current() == lex_quoted_string || _lexer.current() == lex_number ||
+				_lexer.current() == lex_string)
+			{
+				if (_lexer.current() == lex_string)
+				{
+					// This is either a function call, or not - if not, we shall proceed with location path
+					const char_t* state = _lexer.state();
+
+					while (PUGI_IMPL_IS_CHARTYPE(*state, ct_space)) ++state;
+
+					if (*state != '(')
+						return parse_location_path();
+
+					// This looks like a function call; however this still can be a node-test. Check it.
+					if (parse_node_test_type(_lexer.contents()) != nodetest_none)
+						return parse_location_path();
+				}
+
+				xpath_ast_node* n = parse_filter_expression();
+				if (!n) return 0;
+
+				if (_lexer.current() == lex_slash || _lexer.current() == lex_double_slash)
+				{
+					lexeme_t l = _lexer.current();
+					_lexer.next();
+
+					if (l == lex_double_slash)
+					{
+						if (n->rettype() != xpath_type_node_set)
+							return error("Step has to be applied to node set");
+
+						n = alloc_node(ast_step, n, axis_descendant_or_self, nodetest_type_node, 0);
+						if (!n) return 0;
+					}
+
+					// select from location path
+					return parse_relative_location_path(n);
+				}
+
+				return n;
+			}
+			else if (_lexer.current() == lex_minus)
+			{
+				_lexer.next();
+
+				// precedence 7+ - only parses union expressions
+				xpath_ast_node* n = parse_expression(7);
+				if (!n) return 0;
+
+				return alloc_node(ast_op_negate, xpath_type_number, n);
+			}
+			else
+			{
+				return parse_location_path();
+			}
+		}
+
+		struct binary_op_t
+		{
+			ast_type_t asttype;
+			xpath_value_type rettype;
+			int precedence;
+
+			binary_op_t(): asttype(ast_unknown), rettype(xpath_type_none), precedence(0)
+			{
+			}
+
+			binary_op_t(ast_type_t asttype_, xpath_value_type rettype_, int precedence_): asttype(asttype_), rettype(rettype_), precedence(precedence_)
+			{
+			}
+
+			static binary_op_t parse(xpath_lexer& lexer)
+			{
+				switch (lexer.current())
+				{
+				case lex_string:
+					if (lexer.contents() == PUGIXML_TEXT("or"))
+						return binary_op_t(ast_op_or, xpath_type_boolean, 1);
+					else if (lexer.contents() == PUGIXML_TEXT("and"))
+						return binary_op_t(ast_op_and, xpath_type_boolean, 2);
+					else if (lexer.contents() == PUGIXML_TEXT("div"))
+						return binary_op_t(ast_op_divide, xpath_type_number, 6);
+					else if (lexer.contents() == PUGIXML_TEXT("mod"))
+						return binary_op_t(ast_op_mod, xpath_type_number, 6);
+					else
+						return binary_op_t();
+
+				case lex_equal:
+					return binary_op_t(ast_op_equal, xpath_type_boolean, 3);
+
+				case lex_not_equal:
+					return binary_op_t(ast_op_not_equal, xpath_type_boolean, 3);
+
+				case lex_less:
+					return binary_op_t(ast_op_less, xpath_type_boolean, 4);
+
+				case lex_greater:
+					return binary_op_t(ast_op_greater, xpath_type_boolean, 4);
+
+				case lex_less_or_equal:
+					return binary_op_t(ast_op_less_or_equal, xpath_type_boolean, 4);
+
+				case lex_greater_or_equal:
+					return binary_op_t(ast_op_greater_or_equal, xpath_type_boolean, 4);
+
+				case lex_plus:
+					return binary_op_t(ast_op_add, xpath_type_number, 5);
+
+				case lex_minus:
+					return binary_op_t(ast_op_subtract, xpath_type_number, 5);
+
+				case lex_multiply:
+					return binary_op_t(ast_op_multiply, xpath_type_number, 6);
+
+				case lex_union:
+					return binary_op_t(ast_op_union, xpath_type_node_set, 7);
+
+				default:
+					return binary_op_t();
+				}
+			}
+		};
+
+		xpath_ast_node* parse_expression_rec(xpath_ast_node* lhs, int limit)
+		{
+			binary_op_t op = binary_op_t::parse(_lexer);
+
+			while (op.asttype != ast_unknown && op.precedence >= limit)
+			{
+				_lexer.next();
+
+				if (++_depth > xpath_ast_depth_limit)
+					return error_rec();
+
+				xpath_ast_node* rhs = parse_path_or_unary_expression();
+				if (!rhs) return 0;
+
+				binary_op_t nextop = binary_op_t::parse(_lexer);
+
+				while (nextop.asttype != ast_unknown && nextop.precedence > op.precedence)
+				{
+					rhs = parse_expression_rec(rhs, nextop.precedence);
+					if (!rhs) return 0;
+
+					nextop = binary_op_t::parse(_lexer);
+				}
+
+				if (op.asttype == ast_op_union && (lhs->rettype() != xpath_type_node_set || rhs->rettype() != xpath_type_node_set))
+					return error("Union operator has to be applied to node sets");
+
+				lhs = alloc_node(op.asttype, op.rettype, lhs, rhs);
+				if (!lhs) return 0;
+
+				op = binary_op_t::parse(_lexer);
+			}
+
+			return lhs;
+		}
+
+		// Expr ::= OrExpr
+		// OrExpr ::= AndExpr | OrExpr 'or' AndExpr
+		// AndExpr ::= EqualityExpr | AndExpr 'and' EqualityExpr
+		// EqualityExpr ::= RelationalExpr
+		//					| EqualityExpr '=' RelationalExpr
+		//					| EqualityExpr '!=' RelationalExpr
+		// RelationalExpr ::= AdditiveExpr
+		//					  | RelationalExpr '<' AdditiveExpr
+		//					  | RelationalExpr '>' AdditiveExpr
+		//					  | RelationalExpr '<=' AdditiveExpr
+		//					  | RelationalExpr '>=' AdditiveExpr
+		// AdditiveExpr ::= MultiplicativeExpr
+		//					| AdditiveExpr '+' MultiplicativeExpr
+		//					| AdditiveExpr '-' MultiplicativeExpr
+		// MultiplicativeExpr ::= UnaryExpr
+		//						  | MultiplicativeExpr '*' UnaryExpr
+		//						  | MultiplicativeExpr 'div' UnaryExpr
+		//						  | MultiplicativeExpr 'mod' UnaryExpr
+		xpath_ast_node* parse_expression(int limit = 0)
+		{
+			size_t old_depth = _depth;
+
+			if (++_depth > xpath_ast_depth_limit)
+				return error_rec();
+
+			xpath_ast_node* n = parse_path_or_unary_expression();
+			if (!n) return 0;
+
+			n = parse_expression_rec(n, limit);
+
+			_depth = old_depth;
+
+			return n;
+		}
+
+		xpath_parser(const char_t* query, xpath_variable_set* variables, xpath_allocator* alloc, xpath_parse_result* result): _alloc(alloc), _lexer(query), _query(query), _variables(variables), _result(result), _depth(0)
+		{
+		}
+
+		xpath_ast_node* parse()
+		{
+			xpath_ast_node* n = parse_expression();
+			if (!n) return 0;
+
+			assert(_depth == 0);
+
+			// check if there are unparsed tokens left
+			if (_lexer.current() != lex_eof)
+				return error("Incorrect query");
+
+			return n;
+		}
+
+		static xpath_ast_node* parse(const char_t* query, xpath_variable_set* variables, xpath_allocator* alloc, xpath_parse_result* result)
+		{
+			xpath_parser parser(query, variables, alloc, result);
+
+			return parser.parse();
+		}
+	};
+
+	struct xpath_query_impl
+	{
+		static xpath_query_impl* create()
+		{
+			void* memory = xml_memory::allocate(sizeof(xpath_query_impl));
+			if (!memory) return 0;
+
+			return new (memory) xpath_query_impl();
+		}
+
+		static void destroy(xpath_query_impl* impl)
+		{
+			// free all allocated pages
+			impl->alloc.release();
+
+			// free allocator memory (with the first page)
+			xml_memory::deallocate(impl);
+		}
+
+		xpath_query_impl(): root(0), alloc(&block, &oom), oom(false)
+		{
+			block.next = 0;
+			block.capacity = sizeof(block.data);
+		}
+
+		xpath_ast_node* root;
+		xpath_allocator alloc;
+		xpath_memory_block block;
+		bool oom;
+	};
+
+	PUGI_IMPL_FN impl::xpath_ast_node* evaluate_node_set_prepare(xpath_query_impl* impl)
+	{
+		if (!impl) return 0;
+
+		if (impl->root->rettype() != xpath_type_node_set)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return 0;
+		#else
+			xpath_parse_result res;
+			res.error = "Expression does not evaluate to node set";
+
+			throw xpath_exception(res);
+		#endif
+		}
+
+		return impl->root;
+	}
+PUGI_IMPL_NS_END
+
+namespace pugi
+{
+#ifndef PUGIXML_NO_EXCEPTIONS
+	PUGI_IMPL_FN xpath_exception::xpath_exception(const xpath_parse_result& result_): _result(result_)
+	{
+		assert(_result.error);
+	}
+
+	PUGI_IMPL_FN const char* xpath_exception::what() const throw()
+	{
+		return _result.error;
+	}
+
+	PUGI_IMPL_FN const xpath_parse_result& xpath_exception::result() const
+	{
+		return _result;
+	}
+#endif
+
+	PUGI_IMPL_FN xpath_node::xpath_node()
+	{
+	}
+
+	PUGI_IMPL_FN xpath_node::xpath_node(const xml_node& node_): _node(node_)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_node::xpath_node(const xml_attribute& attribute_, const xml_node& parent_): _node(attribute_ ? parent_ : xml_node()), _attribute(attribute_)
+	{
+	}
+
+	PUGI_IMPL_FN xml_node xpath_node::node() const
+	{
+		return _attribute ? xml_node() : _node;
+	}
+
+	PUGI_IMPL_FN xml_attribute xpath_node::attribute() const
+	{
+		return _attribute;
+	}
+
+	PUGI_IMPL_FN xml_node xpath_node::parent() const
+	{
+		return _attribute ? _node : _node.parent();
+	}
+
+	PUGI_IMPL_FN static void unspecified_bool_xpath_node(xpath_node***)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_node::operator xpath_node::unspecified_bool_type() const
+	{
+		return (_node || _attribute) ? unspecified_bool_xpath_node : 0;
+	}
+
+	PUGI_IMPL_FN bool xpath_node::operator!() const
+	{
+		return !(_node || _attribute);
+	}
+
+	PUGI_IMPL_FN bool xpath_node::operator==(const xpath_node& n) const
+	{
+		return _node == n._node && _attribute == n._attribute;
+	}
+
+	PUGI_IMPL_FN bool xpath_node::operator!=(const xpath_node& n) const
+	{
+		return _node != n._node || _attribute != n._attribute;
+	}
+
+#ifdef __BORLANDC__
+	PUGI_IMPL_FN bool operator&&(const xpath_node& lhs, bool rhs)
+	{
+		return (bool)lhs && rhs;
+	}
+
+	PUGI_IMPL_FN bool operator||(const xpath_node& lhs, bool rhs)
+	{
+		return (bool)lhs || rhs;
+	}
+#endif
+
+	PUGI_IMPL_FN void xpath_node_set::_assign(const_iterator begin_, const_iterator end_, type_t type_)
+	{
+		assert(begin_ <= end_);
+
+		size_t size_ = static_cast<size_t>(end_ - begin_);
+
+		// use internal buffer for 0 or 1 elements, heap buffer otherwise
+		xpath_node* storage = (size_ <= 1) ? _storage : static_cast<xpath_node*>(impl::xml_memory::allocate(size_ * sizeof(xpath_node)));
+
+		if (!storage)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return;
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		// deallocate old buffer
+		if (_begin != _storage)
+			impl::xml_memory::deallocate(_begin);
+
+		// size check is necessary because for begin_ = end_ = nullptr, memcpy is UB
+		if (size_)
+			memcpy(storage, begin_, size_ * sizeof(xpath_node));
+
+		_begin = storage;
+		_end = storage + size_;
+		_type = type_;
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN void xpath_node_set::_move(xpath_node_set& rhs) PUGIXML_NOEXCEPT
+	{
+		_type = rhs._type;
+		_storage[0] = rhs._storage[0];
+		_begin = (rhs._begin == rhs._storage) ? _storage : rhs._begin;
+		_end = _begin + (rhs._end - rhs._begin);
+
+		rhs._type = type_unsorted;
+		rhs._begin = rhs._storage;
+		rhs._end = rhs._storage;
+	}
+#endif
+
+	PUGI_IMPL_FN xpath_node_set::xpath_node_set(): _type(type_unsorted), _begin(_storage), _end(_storage)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_node_set::xpath_node_set(const_iterator begin_, const_iterator end_, type_t type_): _type(type_unsorted), _begin(_storage), _end(_storage)
+	{
+		_assign(begin_, end_, type_);
+	}
+
+	PUGI_IMPL_FN xpath_node_set::~xpath_node_set()
+	{
+		if (_begin != _storage)
+			impl::xml_memory::deallocate(_begin);
+	}
+
+	PUGI_IMPL_FN xpath_node_set::xpath_node_set(const xpath_node_set& ns): _type(type_unsorted), _begin(_storage), _end(_storage)
+	{
+		_assign(ns._begin, ns._end, ns._type);
+	}
+
+	PUGI_IMPL_FN xpath_node_set& xpath_node_set::operator=(const xpath_node_set& ns)
+	{
+		if (this == &ns) return *this;
+
+		_assign(ns._begin, ns._end, ns._type);
+
+		return *this;
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN xpath_node_set::xpath_node_set(xpath_node_set&& rhs) PUGIXML_NOEXCEPT: _type(type_unsorted), _begin(_storage), _end(_storage)
+	{
+		_move(rhs);
+	}
+
+	PUGI_IMPL_FN xpath_node_set& xpath_node_set::operator=(xpath_node_set&& rhs) PUGIXML_NOEXCEPT
+	{
+		if (this == &rhs) return *this;
+
+		if (_begin != _storage)
+			impl::xml_memory::deallocate(_begin);
+
+		_move(rhs);
+
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN xpath_node_set::type_t xpath_node_set::type() const
+	{
+		return _type;
+	}
+
+	PUGI_IMPL_FN size_t xpath_node_set::size() const
+	{
+		return _end - _begin;
+	}
+
+	PUGI_IMPL_FN bool xpath_node_set::empty() const
+	{
+		return _begin == _end;
+	}
+
+	PUGI_IMPL_FN const xpath_node& xpath_node_set::operator[](size_t index) const
+	{
+		assert(index < size());
+		return _begin[index];
+	}
+
+	PUGI_IMPL_FN xpath_node_set::const_iterator xpath_node_set::begin() const
+	{
+		return _begin;
+	}
+
+	PUGI_IMPL_FN xpath_node_set::const_iterator xpath_node_set::end() const
+	{
+		return _end;
+	}
+
+	PUGI_IMPL_FN void xpath_node_set::sort(bool reverse)
+	{
+		_type = impl::xpath_sort(_begin, _end, _type, reverse);
+	}
+
+	PUGI_IMPL_FN xpath_node xpath_node_set::first() const
+	{
+		return impl::xpath_first(_begin, _end, _type);
+	}
+
+	PUGI_IMPL_FN xpath_parse_result::xpath_parse_result(): error("Internal error"), offset(0)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_parse_result::operator bool() const
+	{
+		return error == 0;
+	}
+
+	PUGI_IMPL_FN const char* xpath_parse_result::description() const
+	{
+		return error ? error : "No error";
+	}
+
+	PUGI_IMPL_FN xpath_variable::xpath_variable(xpath_value_type type_): _type(type_), _next(0)
+	{
+	}
+
+	PUGI_IMPL_FN const char_t* xpath_variable::name() const
+	{
+		switch (_type)
+		{
+		case xpath_type_node_set:
+			return static_cast<const impl::xpath_variable_node_set*>(this)->name;
+
+		case xpath_type_number:
+			return static_cast<const impl::xpath_variable_number*>(this)->name;
+
+		case xpath_type_string:
+			return static_cast<const impl::xpath_variable_string*>(this)->name;
+
+		case xpath_type_boolean:
+			return static_cast<const impl::xpath_variable_boolean*>(this)->name;
+
+		default:
+			assert(false && "Invalid variable type"); // unreachable
+			return 0;
+		}
+	}
+
+	PUGI_IMPL_FN xpath_value_type xpath_variable::type() const
+	{
+		return _type;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable::get_boolean() const
+	{
+		return (_type == xpath_type_boolean) ? static_cast<const impl::xpath_variable_boolean*>(this)->value : false;
+	}
+
+	PUGI_IMPL_FN double xpath_variable::get_number() const
+	{
+		return (_type == xpath_type_number) ? static_cast<const impl::xpath_variable_number*>(this)->value : impl::gen_nan();
+	}
+
+	PUGI_IMPL_FN const char_t* xpath_variable::get_string() const
+	{
+		const char_t* value = (_type == xpath_type_string) ? static_cast<const impl::xpath_variable_string*>(this)->value : 0;
+		return value ? value : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const xpath_node_set& xpath_variable::get_node_set() const
+	{
+		return (_type == xpath_type_node_set) ? static_cast<const impl::xpath_variable_node_set*>(this)->value : impl::dummy_node_set;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable::set(bool value)
+	{
+		if (_type != xpath_type_boolean) return false;
+
+		static_cast<impl::xpath_variable_boolean*>(this)->value = value;
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable::set(double value)
+	{
+		if (_type != xpath_type_number) return false;
+
+		static_cast<impl::xpath_variable_number*>(this)->value = value;
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable::set(const char_t* value)
+	{
+		if (_type != xpath_type_string) return false;
+
+		impl::xpath_variable_string* var = static_cast<impl::xpath_variable_string*>(this);
+
+		// duplicate string
+		size_t size = (impl::strlength(value) + 1) * sizeof(char_t);
+
+		char_t* copy = static_cast<char_t*>(impl::xml_memory::allocate(size));
+		if (!copy) return false;
+
+		memcpy(copy, value, size);
+
+		// replace old string
+		if (var->value) impl::xml_memory::deallocate(var->value);
+		var->value = copy;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable::set(const xpath_node_set& value)
+	{
+		if (_type != xpath_type_node_set) return false;
+
+		static_cast<impl::xpath_variable_node_set*>(this)->value = value;
+		return true;
+	}
+
+	PUGI_IMPL_FN xpath_variable_set::xpath_variable_set()
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+			_data[i] = 0;
+	}
+
+	PUGI_IMPL_FN xpath_variable_set::~xpath_variable_set()
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+			_destroy(_data[i]);
+	}
+
+	PUGI_IMPL_FN xpath_variable_set::xpath_variable_set(const xpath_variable_set& rhs)
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+			_data[i] = 0;
+
+		_assign(rhs);
+	}
+
+	PUGI_IMPL_FN xpath_variable_set& xpath_variable_set::operator=(const xpath_variable_set& rhs)
+	{
+		if (this == &rhs) return *this;
+
+		_assign(rhs);
+
+		return *this;
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN xpath_variable_set::xpath_variable_set(xpath_variable_set&& rhs) PUGIXML_NOEXCEPT
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+		{
+			_data[i] = rhs._data[i];
+			rhs._data[i] = 0;
+		}
+	}
+
+	PUGI_IMPL_FN xpath_variable_set& xpath_variable_set::operator=(xpath_variable_set&& rhs) PUGIXML_NOEXCEPT
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+		{
+			_destroy(_data[i]);
+
+			_data[i] = rhs._data[i];
+			rhs._data[i] = 0;
+		}
+
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN void xpath_variable_set::_assign(const xpath_variable_set& rhs)
+	{
+		xpath_variable_set temp;
+
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+			if (rhs._data[i] && !_clone(rhs._data[i], &temp._data[i]))
+				return;
+
+		_swap(temp);
+	}
+
+	PUGI_IMPL_FN void xpath_variable_set::_swap(xpath_variable_set& rhs)
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+		{
+			xpath_variable* chain = _data[i];
+
+			_data[i] = rhs._data[i];
+			rhs._data[i] = chain;
+		}
+	}
+
+	PUGI_IMPL_FN xpath_variable* xpath_variable_set::_find(const char_t* name) const
+	{
+		const size_t hash_size = sizeof(_data) / sizeof(_data[0]);
+		size_t hash = impl::hash_string(name) % hash_size;
+
+		// look for existing variable
+		for (xpath_variable* var = _data[hash]; var; var = var->_next)
+			if (impl::strequal(var->name(), name))
+				return var;
+
+		return 0;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable_set::_clone(xpath_variable* var, xpath_variable** out_result)
+	{
+		xpath_variable* last = 0;
+
+		while (var)
+		{
+			// allocate storage for new variable
+			xpath_variable* nvar = impl::new_xpath_variable(var->_type, var->name());
+			if (!nvar) return false;
+
+			// link the variable to the result immediately to handle failures gracefully
+			if (last)
+				last->_next = nvar;
+			else
+				*out_result = nvar;
+
+			last = nvar;
+
+			// copy the value; this can fail due to out-of-memory conditions
+			if (!impl::copy_xpath_variable(nvar, var)) return false;
+
+			var = var->_next;
+		}
+
+		return true;
+	}
+
+	PUGI_IMPL_FN void xpath_variable_set::_destroy(xpath_variable* var)
+	{
+		while (var)
+		{
+			xpath_variable* next = var->_next;
+
+			impl::delete_xpath_variable(var->_type, var);
+
+			var = next;
+		}
+	}
+
+	PUGI_IMPL_FN xpath_variable* xpath_variable_set::add(const char_t* name, xpath_value_type type)
+	{
+		const size_t hash_size = sizeof(_data) / sizeof(_data[0]);
+		size_t hash = impl::hash_string(name) % hash_size;
+
+		// look for existing variable
+		for (xpath_variable* var = _data[hash]; var; var = var->_next)
+			if (impl::strequal(var->name(), name))
+				return var->type() == type ? var : 0;
+
+		// add new variable
+		xpath_variable* result = impl::new_xpath_variable(type, name);
+
+		if (result)
+		{
+			result->_next = _data[hash];
+
+			_data[hash] = result;
+		}
+
+		return result;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable_set::set(const char_t* name, bool value)
+	{
+		xpath_variable* var = add(name, xpath_type_boolean);
+		return var ? var->set(value) : false;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable_set::set(const char_t* name, double value)
+	{
+		xpath_variable* var = add(name, xpath_type_number);
+		return var ? var->set(value) : false;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable_set::set(const char_t* name, const char_t* value)
+	{
+		xpath_variable* var = add(name, xpath_type_string);
+		return var ? var->set(value) : false;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable_set::set(const char_t* name, const xpath_node_set& value)
+	{
+		xpath_variable* var = add(name, xpath_type_node_set);
+		return var ? var->set(value) : false;
+	}
+
+	PUGI_IMPL_FN xpath_variable* xpath_variable_set::get(const char_t* name)
+	{
+		return _find(name);
+	}
+
+	PUGI_IMPL_FN const xpath_variable* xpath_variable_set::get(const char_t* name) const
+	{
+		return _find(name);
+	}
+
+	PUGI_IMPL_FN xpath_query::xpath_query(const char_t* query, xpath_variable_set* variables): _impl(0)
+	{
+		impl::xpath_query_impl* qimpl = impl::xpath_query_impl::create();
+
+		if (!qimpl)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			_result.error = "Out of memory";
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+		else
+		{
+			using impl::auto_deleter; // MSVC7 workaround
+			auto_deleter<impl::xpath_query_impl> impl(qimpl, impl::xpath_query_impl::destroy);
+
+			qimpl->root = impl::xpath_parser::parse(query, variables, &qimpl->alloc, &_result);
+
+			if (qimpl->root)
+			{
+				qimpl->root->optimize(&qimpl->alloc);
+
+				_impl = impl.release();
+				_result.error = 0;
+			}
+			else
+			{
+			#ifdef PUGIXML_NO_EXCEPTIONS
+				if (qimpl->oom) _result.error = "Out of memory";
+			#else
+				if (qimpl->oom) throw std::bad_alloc();
+				throw xpath_exception(_result);
+			#endif
+			}
+		}
+	}
+
+	PUGI_IMPL_FN xpath_query::xpath_query(): _impl(0)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_query::~xpath_query()
+	{
+		if (_impl)
+			impl::xpath_query_impl::destroy(static_cast<impl::xpath_query_impl*>(_impl));
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN xpath_query::xpath_query(xpath_query&& rhs) PUGIXML_NOEXCEPT
+	{
+		_impl = rhs._impl;
+		_result = rhs._result;
+		rhs._impl = 0;
+		rhs._result = xpath_parse_result();
+	}
+
+	PUGI_IMPL_FN xpath_query& xpath_query::operator=(xpath_query&& rhs) PUGIXML_NOEXCEPT
+	{
+		if (this == &rhs) return *this;
+
+		if (_impl)
+			impl::xpath_query_impl::destroy(static_cast<impl::xpath_query_impl*>(_impl));
+
+		_impl = rhs._impl;
+		_result = rhs._result;
+		rhs._impl = 0;
+		rhs._result = xpath_parse_result();
+
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN xpath_value_type xpath_query::return_type() const
+	{
+		if (!_impl) return xpath_type_none;
+
+		return static_cast<impl::xpath_query_impl*>(_impl)->root->rettype();
+	}
+
+	PUGI_IMPL_FN bool xpath_query::evaluate_boolean(const xpath_node& n) const
+	{
+		if (!_impl) return false;
+
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		bool r = static_cast<impl::xpath_query_impl*>(_impl)->root->eval_boolean(c, sd.stack);
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return false;
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		return r;
+	}
+
+	PUGI_IMPL_FN double xpath_query::evaluate_number(const xpath_node& n) const
+	{
+		if (!_impl) return impl::gen_nan();
+
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		double r = static_cast<impl::xpath_query_impl*>(_impl)->root->eval_number(c, sd.stack);
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return impl::gen_nan();
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		return r;
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN string_t xpath_query::evaluate_string(const xpath_node& n) const
+	{
+		if (!_impl) return string_t();
+
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		impl::xpath_string r = static_cast<impl::xpath_query_impl*>(_impl)->root->eval_string(c, sd.stack);
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return string_t();
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		return string_t(r.c_str(), r.length());
+	}
+#endif
+
+	PUGI_IMPL_FN size_t xpath_query::evaluate_string(char_t* buffer, size_t capacity, const xpath_node& n) const
+	{
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		impl::xpath_string r = _impl ? static_cast<impl::xpath_query_impl*>(_impl)->root->eval_string(c, sd.stack) : impl::xpath_string();
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			r = impl::xpath_string();
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		size_t full_size = r.length() + 1;
+
+		if (capacity > 0)
+		{
+			size_t size = (full_size < capacity) ? full_size : capacity;
+			assert(size > 0);
+
+			memcpy(buffer, r.c_str(), (size - 1) * sizeof(char_t));
+			buffer[size - 1] = 0;
+		}
+
+		return full_size;
+	}
+
+	PUGI_IMPL_FN xpath_node_set xpath_query::evaluate_node_set(const xpath_node& n) const
+	{
+		impl::xpath_ast_node* root = impl::evaluate_node_set_prepare(static_cast<impl::xpath_query_impl*>(_impl));
+		if (!root) return xpath_node_set();
+
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		impl::xpath_node_set_raw r = root->eval_node_set(c, sd.stack, impl::nodeset_eval_all);
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return xpath_node_set();
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		return xpath_node_set(r.begin(), r.end(), r.type());
+	}
+
+	PUGI_IMPL_FN xpath_node xpath_query::evaluate_node(const xpath_node& n) const
+	{
+		impl::xpath_ast_node* root = impl::evaluate_node_set_prepare(static_cast<impl::xpath_query_impl*>(_impl));
+		if (!root) return xpath_node();
+
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		impl::xpath_node_set_raw r = root->eval_node_set(c, sd.stack, impl::nodeset_eval_first);
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return xpath_node();
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		return r.first();
+	}
+
+	PUGI_IMPL_FN const xpath_parse_result& xpath_query::result() const
+	{
+		return _result;
+	}
+
+	PUGI_IMPL_FN static void unspecified_bool_xpath_query(xpath_query***)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_query::operator xpath_query::unspecified_bool_type() const
+	{
+		return _impl ? unspecified_bool_xpath_query : 0;
+	}
+
+	PUGI_IMPL_FN bool xpath_query::operator!() const
+	{
+		return !_impl;
+	}
+
+	PUGI_IMPL_FN xpath_node xml_node::select_node(const char_t* query, xpath_variable_set* variables) const
+	{
+		xpath_query q(query, variables);
+		return q.evaluate_node(*this);
+	}
+
+	PUGI_IMPL_FN xpath_node xml_node::select_node(const xpath_query& query) const
+	{
+		return query.evaluate_node(*this);
+	}
+
+	PUGI_IMPL_FN xpath_node_set xml_node::select_nodes(const char_t* query, xpath_variable_set* variables) const
+	{
+		xpath_query q(query, variables);
+		return q.evaluate_node_set(*this);
+	}
+
+	PUGI_IMPL_FN xpath_node_set xml_node::select_nodes(const xpath_query& query) const
+	{
+		return query.evaluate_node_set(*this);
+	}
+
+	PUGI_IMPL_FN xpath_node xml_node::select_single_node(const char_t* query, xpath_variable_set* variables) const
+	{
+		xpath_query q(query, variables);
+		return q.evaluate_node(*this);
+	}
+
+	PUGI_IMPL_FN xpath_node xml_node::select_single_node(const xpath_query& query) const
+	{
+		return query.evaluate_node(*this);
+	}
+}
+
+#endif
+
+#ifdef __BORLANDC__
+#	pragma option pop
+#endif
+
+// Intel C++ does not properly keep warning state for function templates,
+// so popping warning state at the end of translation unit leads to warnings in the middle.
+#if defined(_MSC_VER) && !defined(__INTEL_COMPILER)
+#	pragma warning(pop)
+#endif
+
+#if defined(_MSC_VER) && defined(__c2__)
+#	pragma clang diagnostic pop
+#endif
+
+// Undefine all local macros (makes sure we're not leaking macros in header-only mode)
+#undef PUGI_IMPL_NO_INLINE
+#undef PUGI_IMPL_UNLIKELY
+#undef PUGI_IMPL_STATIC_ASSERT
+#undef PUGI_IMPL_DMC_VOLATILE
+#undef PUGI_IMPL_UNSIGNED_OVERFLOW
+#undef PUGI_IMPL_MSVC_CRT_VERSION
+#undef PUGI_IMPL_SNPRINTF
+#undef PUGI_IMPL_NS_BEGIN
+#undef PUGI_IMPL_NS_END
+#undef PUGI_IMPL_FN
+#undef PUGI_IMPL_FN_NO_INLINE
+#undef PUGI_IMPL_GETHEADER_IMPL
+#undef PUGI_IMPL_GETPAGE_IMPL
+#undef PUGI_IMPL_GETPAGE
+#undef PUGI_IMPL_NODETYPE
+#undef PUGI_IMPL_IS_CHARTYPE_IMPL
+#undef PUGI_IMPL_IS_CHARTYPE
+#undef PUGI_IMPL_IS_CHARTYPEX
+#undef PUGI_IMPL_ENDSWITH
+#undef PUGI_IMPL_SKIPWS
+#undef PUGI_IMPL_OPTSET
+#undef PUGI_IMPL_PUSHNODE
+#undef PUGI_IMPL_POPNODE
+#undef PUGI_IMPL_SCANFOR
+#undef PUGI_IMPL_SCANWHILE
+#undef PUGI_IMPL_SCANWHILE_UNROLL
+#undef PUGI_IMPL_ENDSEG
+#undef PUGI_IMPL_THROW_ERROR
+#undef PUGI_IMPL_CHECK_ERROR
+
+#endif
+
+/**
+ * Copyright (c) 2006-2023 Arseny Kapoulkine
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */

+ 1516 - 0
pico-tcp-service/pico-tcp-client/pugixml.hpp

@@ -0,0 +1,1516 @@
+/**
+ * pugixml parser - version 1.14
+ * --------------------------------------------------------
+ * Copyright (C) 2006-2023, by Arseny Kapoulkine (arseny.kapoulkine@gmail.com)
+ * Report bugs and download new versions at https://pugixml.org/
+ *
+ * This library is distributed under the MIT License. See notice at the end
+ * of this file.
+ *
+ * This work is based on the pugxml parser, which is:
+ * Copyright (C) 2003, by Kristen Wegner (kristen@tima.net)
+ */
+
+// Define version macro; evaluates to major * 1000 + minor * 10 + patch so that it's safe to use in less-than comparisons
+// Note: pugixml used major * 100 + minor * 10 + patch format up until 1.9 (which had version identifier 190); starting from pugixml 1.10, the minor version number is two digits
+#ifndef PUGIXML_VERSION
+#	define PUGIXML_VERSION 1140 // 1.14
+#endif
+
+// Include user configuration file (this can define various configuration macros)
+#include "pugiconfig.hpp"
+
+#ifndef HEADER_PUGIXML_HPP
+#define HEADER_PUGIXML_HPP
+
+// Include stddef.h for size_t and ptrdiff_t
+#include <stddef.h>
+
+// Include exception header for XPath
+#if !defined(PUGIXML_NO_XPATH) && !defined(PUGIXML_NO_EXCEPTIONS)
+#	include <exception>
+#endif
+
+// Include STL headers
+#ifndef PUGIXML_NO_STL
+#	include <iterator>
+#	include <iosfwd>
+#	include <string>
+#endif
+
+// Macro for deprecated features
+#ifndef PUGIXML_DEPRECATED
+#	if defined(__GNUC__)
+#		define PUGIXML_DEPRECATED __attribute__((deprecated))
+#	elif defined(_MSC_VER) && _MSC_VER >= 1300
+#		define PUGIXML_DEPRECATED __declspec(deprecated)
+#	else
+#		define PUGIXML_DEPRECATED
+#	endif
+#endif
+
+// If no API is defined, assume default
+#ifndef PUGIXML_API
+#	define PUGIXML_API
+#endif
+
+// If no API for classes is defined, assume default
+#ifndef PUGIXML_CLASS
+#	define PUGIXML_CLASS PUGIXML_API
+#endif
+
+// If no API for functions is defined, assume default
+#ifndef PUGIXML_FUNCTION
+#	define PUGIXML_FUNCTION PUGIXML_API
+#endif
+
+// If the platform is known to have long long support, enable long long functions
+#ifndef PUGIXML_HAS_LONG_LONG
+#	if __cplusplus >= 201103
+#		define PUGIXML_HAS_LONG_LONG
+#	elif defined(_MSC_VER) && _MSC_VER >= 1400
+#		define PUGIXML_HAS_LONG_LONG
+#	endif
+#endif
+
+// If the platform is known to have move semantics support, compile move ctor/operator implementation
+#ifndef PUGIXML_HAS_MOVE
+#	if __cplusplus >= 201103
+#		define PUGIXML_HAS_MOVE
+#	elif defined(_MSC_VER) && _MSC_VER >= 1600
+#		define PUGIXML_HAS_MOVE
+#	endif
+#endif
+
+// If C++ is 2011 or higher, add 'noexcept' specifiers
+#ifndef PUGIXML_NOEXCEPT
+#	if __cplusplus >= 201103
+#		define PUGIXML_NOEXCEPT noexcept
+#	elif defined(_MSC_VER) && _MSC_VER >= 1900
+#		define PUGIXML_NOEXCEPT noexcept
+#	else
+#		define PUGIXML_NOEXCEPT
+#	endif
+#endif
+
+// Some functions can not be noexcept in compact mode
+#ifdef PUGIXML_COMPACT
+#	define PUGIXML_NOEXCEPT_IF_NOT_COMPACT
+#else
+#	define PUGIXML_NOEXCEPT_IF_NOT_COMPACT PUGIXML_NOEXCEPT
+#endif
+
+// If C++ is 2011 or higher, add 'override' qualifiers
+#ifndef PUGIXML_OVERRIDE
+#	if __cplusplus >= 201103
+#		define PUGIXML_OVERRIDE override
+#	elif defined(_MSC_VER) && _MSC_VER >= 1700
+#		define PUGIXML_OVERRIDE override
+#	else
+#		define PUGIXML_OVERRIDE
+#	endif
+#endif
+
+// If C++ is 2011 or higher, use 'nullptr'
+#ifndef PUGIXML_NULL
+#	if __cplusplus >= 201103
+#		define PUGIXML_NULL nullptr
+#	elif defined(_MSC_VER) && _MSC_VER >= 1600
+#		define PUGIXML_NULL nullptr
+#	else
+#		define PUGIXML_NULL 0
+#	endif
+#endif
+
+// Character interface macros
+#ifdef PUGIXML_WCHAR_MODE
+#	define PUGIXML_TEXT(t) L ## t
+#	define PUGIXML_CHAR wchar_t
+#else
+#	define PUGIXML_TEXT(t) t
+#	define PUGIXML_CHAR char
+#endif
+
+namespace pugi
+{
+	// Character type used for all internal storage and operations; depends on PUGIXML_WCHAR_MODE
+	typedef PUGIXML_CHAR char_t;
+
+#ifndef PUGIXML_NO_STL
+	// String type used for operations that work with STL string; depends on PUGIXML_WCHAR_MODE
+	typedef std::basic_string<PUGIXML_CHAR, std::char_traits<PUGIXML_CHAR>, std::allocator<PUGIXML_CHAR> > string_t;
+#endif
+}
+
+// The PugiXML namespace
+namespace pugi
+{
+	// Tree node types
+	enum xml_node_type
+	{
+		node_null,			// Empty (null) node handle
+		node_document,		// A document tree's absolute root
+		node_element,		// Element tag, i.e. '<node/>'
+		node_pcdata,		// Plain character data, i.e. 'text'
+		node_cdata,			// Character data, i.e. '<![CDATA[text]]>'
+		node_comment,		// Comment tag, i.e. '<!-- text -->'
+		node_pi,			// Processing instruction, i.e. '<?name?>'
+		node_declaration,	// Document declaration, i.e. '<?xml version="1.0"?>'
+		node_doctype		// Document type declaration, i.e. '<!DOCTYPE doc>'
+	};
+
+	// Parsing options
+
+	// Minimal parsing mode (equivalent to turning all other flags off).
+	// Only elements and PCDATA sections are added to the DOM tree, no text conversions are performed.
+	const unsigned int parse_minimal = 0x0000;
+
+	// This flag determines if processing instructions (node_pi) are added to the DOM tree. This flag is off by default.
+	const unsigned int parse_pi = 0x0001;
+
+	// This flag determines if comments (node_comment) are added to the DOM tree. This flag is off by default.
+	const unsigned int parse_comments = 0x0002;
+
+	// This flag determines if CDATA sections (node_cdata) are added to the DOM tree. This flag is on by default.
+	const unsigned int parse_cdata = 0x0004;
+
+	// This flag determines if plain character data (node_pcdata) that consist only of whitespace are added to the DOM tree.
+	// This flag is off by default; turning it on usually results in slower parsing and more memory consumption.
+	const unsigned int parse_ws_pcdata = 0x0008;
+
+	// This flag determines if character and entity references are expanded during parsing. This flag is on by default.
+	const unsigned int parse_escapes = 0x0010;
+
+	// This flag determines if EOL characters are normalized (converted to #xA) during parsing. This flag is on by default.
+	const unsigned int parse_eol = 0x0020;
+
+	// This flag determines if attribute values are normalized using CDATA normalization rules during parsing. This flag is on by default.
+	const unsigned int parse_wconv_attribute = 0x0040;
+
+	// This flag determines if attribute values are normalized using NMTOKENS normalization rules during parsing. This flag is off by default.
+	const unsigned int parse_wnorm_attribute = 0x0080;
+
+	// This flag determines if document declaration (node_declaration) is added to the DOM tree. This flag is off by default.
+	const unsigned int parse_declaration = 0x0100;
+
+	// This flag determines if document type declaration (node_doctype) is added to the DOM tree. This flag is off by default.
+	const unsigned int parse_doctype = 0x0200;
+
+	// This flag determines if plain character data (node_pcdata) that is the only child of the parent node and that consists only
+	// of whitespace is added to the DOM tree.
+	// This flag is off by default; turning it on may result in slower parsing and more memory consumption.
+	const unsigned int parse_ws_pcdata_single = 0x0400;
+
+	// This flag determines if leading and trailing whitespace is to be removed from plain character data. This flag is off by default.
+	const unsigned int parse_trim_pcdata = 0x0800;
+
+	// This flag determines if plain character data that does not have a parent node is added to the DOM tree, and if an empty document
+	// is a valid document. This flag is off by default.
+	const unsigned int parse_fragment = 0x1000;
+
+	// This flag determines if plain character data is be stored in the parent element's value. This significantly changes the structure of
+	// the document; this flag is only recommended for parsing documents with many PCDATA nodes in memory-constrained environments.
+	// This flag is off by default.
+	const unsigned int parse_embed_pcdata = 0x2000;
+	
+	// This flag determines whether determines whether the the two pcdata should be merged or not, if no intermediatory data are parsed in the document.
+	// This flag is off by default.
+	const unsigned int parse_merge_pcdata = 0x4000;
+
+	// The default parsing mode.
+	// Elements, PCDATA and CDATA sections are added to the DOM tree, character/reference entities are expanded,
+	// End-of-Line characters are normalized, attribute values are normalized using CDATA normalization rules.
+	const unsigned int parse_default = parse_cdata | parse_escapes | parse_wconv_attribute | parse_eol;
+
+	// The full parsing mode.
+	// Nodes of all types are added to the DOM tree, character/reference entities are expanded,
+	// End-of-Line characters are normalized, attribute values are normalized using CDATA normalization rules.
+	const unsigned int parse_full = parse_default | parse_pi | parse_comments | parse_declaration | parse_doctype;
+
+	// These flags determine the encoding of input data for XML document
+	enum xml_encoding
+	{
+		encoding_auto,		// Auto-detect input encoding using BOM or < / <? detection; use UTF8 if BOM is not found
+		encoding_utf8,		// UTF8 encoding
+		encoding_utf16_le,	// Little-endian UTF16
+		encoding_utf16_be,	// Big-endian UTF16
+		encoding_utf16,		// UTF16 with native endianness
+		encoding_utf32_le,	// Little-endian UTF32
+		encoding_utf32_be,	// Big-endian UTF32
+		encoding_utf32,		// UTF32 with native endianness
+		encoding_wchar,		// The same encoding wchar_t has (either UTF16 or UTF32)
+		encoding_latin1
+	};
+
+	// Formatting flags
+
+	// Indent the nodes that are written to output stream with as many indentation strings as deep the node is in DOM tree. This flag is on by default.
+	const unsigned int format_indent = 0x01;
+
+	// Write encoding-specific BOM to the output stream. This flag is off by default.
+	const unsigned int format_write_bom = 0x02;
+
+	// Use raw output mode (no indentation and no line breaks are written). This flag is off by default.
+	const unsigned int format_raw = 0x04;
+
+	// Omit default XML declaration even if there is no declaration in the document. This flag is off by default.
+	const unsigned int format_no_declaration = 0x08;
+
+	// Don't escape attribute values and PCDATA contents. This flag is off by default.
+	const unsigned int format_no_escapes = 0x10;
+
+	// Open file using text mode in xml_document::save_file. This enables special character (i.e. new-line) conversions on some systems. This flag is off by default.
+	const unsigned int format_save_file_text = 0x20;
+
+	// Write every attribute on a new line with appropriate indentation. This flag is off by default.
+	const unsigned int format_indent_attributes = 0x40;
+
+	// Don't output empty element tags, instead writing an explicit start and end tag even if there are no children. This flag is off by default.
+	const unsigned int format_no_empty_element_tags = 0x80;
+
+	// Skip characters belonging to range [0; 32) instead of "&#xNN;" encoding. This flag is off by default.
+	const unsigned int format_skip_control_chars = 0x100;
+
+	// Use single quotes ' instead of double quotes " for enclosing attribute values. This flag is off by default.
+	const unsigned int format_attribute_single_quote = 0x200;
+
+	// The default set of formatting flags.
+	// Nodes are indented depending on their depth in DOM tree, a default declaration is output if document has none.
+	const unsigned int format_default = format_indent;
+
+	const int default_double_precision = 17;
+	const int default_float_precision = 9;
+
+	// Forward declarations
+	struct xml_attribute_struct;
+	struct xml_node_struct;
+
+	class xml_node_iterator;
+	class xml_attribute_iterator;
+	class xml_named_node_iterator;
+
+	class xml_tree_walker;
+
+	struct xml_parse_result;
+
+	class xml_node;
+
+	class xml_text;
+
+	#ifndef PUGIXML_NO_XPATH
+	class xpath_node;
+	class xpath_node_set;
+	class xpath_query;
+	class xpath_variable_set;
+	#endif
+
+	// Range-based for loop support
+	template <typename It> class xml_object_range
+	{
+	public:
+		typedef It const_iterator;
+		typedef It iterator;
+
+		xml_object_range(It b, It e): _begin(b), _end(e)
+		{
+		}
+
+		It begin() const { return _begin; }
+		It end() const { return _end; }
+
+		bool empty() const { return _begin == _end; }
+
+	private:
+		It _begin, _end;
+	};
+
+	// Writer interface for node printing (see xml_node::print)
+	class PUGIXML_CLASS xml_writer
+	{
+	public:
+		virtual ~xml_writer();
+
+		// Write memory chunk into stream/file/whatever
+		virtual void write(const void* data, size_t size) = 0;
+	};
+
+	// xml_writer implementation for FILE*
+	class PUGIXML_CLASS xml_writer_file: public xml_writer
+	{
+	public:
+		// Construct writer from a FILE* object; void* is used to avoid header dependencies on stdio
+		xml_writer_file(void* file);
+
+		virtual void write(const void* data, size_t size) PUGIXML_OVERRIDE;
+
+	private:
+		void* file;
+	};
+
+	#ifndef PUGIXML_NO_STL
+	// xml_writer implementation for streams
+	class PUGIXML_CLASS xml_writer_stream: public xml_writer
+	{
+	public:
+		// Construct writer from an output stream object
+		xml_writer_stream(std::basic_ostream<char, std::char_traits<char> >& stream);
+		xml_writer_stream(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& stream);
+
+		virtual void write(const void* data, size_t size) PUGIXML_OVERRIDE;
+
+	private:
+		std::basic_ostream<char, std::char_traits<char> >* narrow_stream;
+		std::basic_ostream<wchar_t, std::char_traits<wchar_t> >* wide_stream;
+	};
+	#endif
+
+	// A light-weight handle for manipulating attributes in DOM tree
+	class PUGIXML_CLASS xml_attribute
+	{
+		friend class xml_attribute_iterator;
+		friend class xml_node;
+
+	private:
+		xml_attribute_struct* _attr;
+
+		typedef void (*unspecified_bool_type)(xml_attribute***);
+
+	public:
+		// Default constructor. Constructs an empty attribute.
+		xml_attribute();
+
+		// Constructs attribute from internal pointer
+		explicit xml_attribute(xml_attribute_struct* attr);
+
+		// Safe bool conversion operator
+		operator unspecified_bool_type() const;
+
+		// Borland C++ workaround
+		bool operator!() const;
+
+		// Comparison operators (compares wrapped attribute pointers)
+		bool operator==(const xml_attribute& r) const;
+		bool operator!=(const xml_attribute& r) const;
+		bool operator<(const xml_attribute& r) const;
+		bool operator>(const xml_attribute& r) const;
+		bool operator<=(const xml_attribute& r) const;
+		bool operator>=(const xml_attribute& r) const;
+
+		// Check if attribute is empty
+		bool empty() const;
+
+		// Get attribute name/value, or "" if attribute is empty
+		const char_t* name() const;
+		const char_t* value() const;
+
+		// Get attribute value, or the default value if attribute is empty
+		const char_t* as_string(const char_t* def = PUGIXML_TEXT("")) const;
+
+		// Get attribute value as a number, or the default value if conversion did not succeed or attribute is empty
+		int as_int(int def = 0) const;
+		unsigned int as_uint(unsigned int def = 0) const;
+		double as_double(double def = 0) const;
+		float as_float(float def = 0) const;
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		long long as_llong(long long def = 0) const;
+		unsigned long long as_ullong(unsigned long long def = 0) const;
+	#endif
+
+		// Get attribute value as bool (returns true if first character is in '1tTyY' set), or the default value if attribute is empty
+		bool as_bool(bool def = false) const;
+
+		// Set attribute name/value (returns false if attribute is empty or there is not enough memory)
+		bool set_name(const char_t* rhs);
+		bool set_name(const char_t* rhs, size_t size);
+		bool set_value(const char_t* rhs);
+		bool set_value(const char_t* rhs, size_t size);
+
+		// Set attribute value with type conversion (numbers are converted to strings, boolean is converted to "true"/"false")
+		bool set_value(int rhs);
+		bool set_value(unsigned int rhs);
+		bool set_value(long rhs);
+		bool set_value(unsigned long rhs);
+		bool set_value(double rhs);
+		bool set_value(double rhs, int precision);
+		bool set_value(float rhs);
+		bool set_value(float rhs, int precision);
+		bool set_value(bool rhs);
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		bool set_value(long long rhs);
+		bool set_value(unsigned long long rhs);
+	#endif
+
+		// Set attribute value (equivalent to set_value without error checking)
+		xml_attribute& operator=(const char_t* rhs);
+		xml_attribute& operator=(int rhs);
+		xml_attribute& operator=(unsigned int rhs);
+		xml_attribute& operator=(long rhs);
+		xml_attribute& operator=(unsigned long rhs);
+		xml_attribute& operator=(double rhs);
+		xml_attribute& operator=(float rhs);
+		xml_attribute& operator=(bool rhs);
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		xml_attribute& operator=(long long rhs);
+		xml_attribute& operator=(unsigned long long rhs);
+	#endif
+
+		// Get next/previous attribute in the attribute list of the parent node
+		xml_attribute next_attribute() const;
+		xml_attribute previous_attribute() const;
+
+		// Get hash value (unique for handles to the same object)
+		size_t hash_value() const;
+
+		// Get internal pointer
+		xml_attribute_struct* internal_object() const;
+	};
+
+#ifdef __BORLANDC__
+	// Borland C++ workaround
+	bool PUGIXML_FUNCTION operator&&(const xml_attribute& lhs, bool rhs);
+	bool PUGIXML_FUNCTION operator||(const xml_attribute& lhs, bool rhs);
+#endif
+
+	// A light-weight handle for manipulating nodes in DOM tree
+	class PUGIXML_CLASS xml_node
+	{
+		friend class xml_attribute_iterator;
+		friend class xml_node_iterator;
+		friend class xml_named_node_iterator;
+
+	protected:
+		xml_node_struct* _root;
+
+		typedef void (*unspecified_bool_type)(xml_node***);
+
+	public:
+		// Default constructor. Constructs an empty node.
+		xml_node();
+
+		// Constructs node from internal pointer
+		explicit xml_node(xml_node_struct* p);
+
+		// Safe bool conversion operator
+		operator unspecified_bool_type() const;
+
+		// Borland C++ workaround
+		bool operator!() const;
+
+		// Comparison operators (compares wrapped node pointers)
+		bool operator==(const xml_node& r) const;
+		bool operator!=(const xml_node& r) const;
+		bool operator<(const xml_node& r) const;
+		bool operator>(const xml_node& r) const;
+		bool operator<=(const xml_node& r) const;
+		bool operator>=(const xml_node& r) const;
+
+		// Check if node is empty.
+		bool empty() const;
+
+		// Get node type
+		xml_node_type type() const;
+
+		// Get node name, or "" if node is empty or it has no name
+		const char_t* name() const;
+
+		// Get node value, or "" if node is empty or it has no value
+		// Note: For <node>text</node> node.value() does not return "text"! Use child_value() or text() methods to access text inside nodes.
+		const char_t* value() const;
+
+		// Get attribute list
+		xml_attribute first_attribute() const;
+		xml_attribute last_attribute() const;
+
+		// Get children list
+		xml_node first_child() const;
+		xml_node last_child() const;
+
+		// Get next/previous sibling in the children list of the parent node
+		xml_node next_sibling() const;
+		xml_node previous_sibling() const;
+
+		// Get parent node
+		xml_node parent() const;
+
+		// Get root of DOM tree this node belongs to
+		xml_node root() const;
+
+		// Get text object for the current node
+		xml_text text() const;
+
+		// Get child, attribute or next/previous sibling with the specified name
+		xml_node child(const char_t* name) const;
+		xml_attribute attribute(const char_t* name) const;
+		xml_node next_sibling(const char_t* name) const;
+		xml_node previous_sibling(const char_t* name) const;
+
+		// Get attribute, starting the search from a hint (and updating hint so that searching for a sequence of attributes is fast)
+		xml_attribute attribute(const char_t* name, xml_attribute& hint) const;
+
+		// Get child value of current node; that is, value of the first child node of type PCDATA/CDATA
+		const char_t* child_value() const;
+
+		// Get child value of child with specified name. Equivalent to child(name).child_value().
+		const char_t* child_value(const char_t* name) const;
+
+		// Set node name/value (returns false if node is empty, there is not enough memory, or node can not have name/value)
+		bool set_name(const char_t* rhs);
+		bool set_name(const char_t* rhs, size_t size);
+		bool set_value(const char_t* rhs);
+		bool set_value(const char_t* rhs, size_t size);
+
+		// Add attribute with specified name. Returns added attribute, or empty attribute on errors.
+		xml_attribute append_attribute(const char_t* name);
+		xml_attribute prepend_attribute(const char_t* name);
+		xml_attribute insert_attribute_after(const char_t* name, const xml_attribute& attr);
+		xml_attribute insert_attribute_before(const char_t* name, const xml_attribute& attr);
+
+		// Add a copy of the specified attribute. Returns added attribute, or empty attribute on errors.
+		xml_attribute append_copy(const xml_attribute& proto);
+		xml_attribute prepend_copy(const xml_attribute& proto);
+		xml_attribute insert_copy_after(const xml_attribute& proto, const xml_attribute& attr);
+		xml_attribute insert_copy_before(const xml_attribute& proto, const xml_attribute& attr);
+
+		// Add child node with specified type. Returns added node, or empty node on errors.
+		xml_node append_child(xml_node_type type = node_element);
+		xml_node prepend_child(xml_node_type type = node_element);
+		xml_node insert_child_after(xml_node_type type, const xml_node& node);
+		xml_node insert_child_before(xml_node_type type, const xml_node& node);
+
+		// Add child element with specified name. Returns added node, or empty node on errors.
+		xml_node append_child(const char_t* name);
+		xml_node prepend_child(const char_t* name);
+		xml_node insert_child_after(const char_t* name, const xml_node& node);
+		xml_node insert_child_before(const char_t* name, const xml_node& node);
+
+		// Add a copy of the specified node as a child. Returns added node, or empty node on errors.
+		xml_node append_copy(const xml_node& proto);
+		xml_node prepend_copy(const xml_node& proto);
+		xml_node insert_copy_after(const xml_node& proto, const xml_node& node);
+		xml_node insert_copy_before(const xml_node& proto, const xml_node& node);
+
+		// Move the specified node to become a child of this node. Returns moved node, or empty node on errors.
+		xml_node append_move(const xml_node& moved);
+		xml_node prepend_move(const xml_node& moved);
+		xml_node insert_move_after(const xml_node& moved, const xml_node& node);
+		xml_node insert_move_before(const xml_node& moved, const xml_node& node);
+
+		// Remove specified attribute
+		bool remove_attribute(const xml_attribute& a);
+		bool remove_attribute(const char_t* name);
+
+		// Remove all attributes
+		bool remove_attributes();
+
+		// Remove specified child
+		bool remove_child(const xml_node& n);
+		bool remove_child(const char_t* name);
+
+		// Remove all children
+		bool remove_children();
+
+		// Parses buffer as an XML document fragment and appends all nodes as children of the current node.
+		// Copies/converts the buffer, so it may be deleted or changed after the function returns.
+		// Note: append_buffer allocates memory that has the lifetime of the owning document; removing the appended nodes does not immediately reclaim that memory.
+		xml_parse_result append_buffer(const void* contents, size_t size, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+
+		// Find attribute using predicate. Returns first attribute for which predicate returned true.
+		template <typename Predicate> xml_attribute find_attribute(Predicate pred) const
+		{
+			if (!_root) return xml_attribute();
+
+			for (xml_attribute attrib = first_attribute(); attrib; attrib = attrib.next_attribute())
+				if (pred(attrib))
+					return attrib;
+
+			return xml_attribute();
+		}
+
+		// Find child node using predicate. Returns first child for which predicate returned true.
+		template <typename Predicate> xml_node find_child(Predicate pred) const
+		{
+			if (!_root) return xml_node();
+
+			for (xml_node node = first_child(); node; node = node.next_sibling())
+				if (pred(node))
+					return node;
+
+			return xml_node();
+		}
+
+		// Find node from subtree using predicate. Returns first node from subtree (depth-first), for which predicate returned true.
+		template <typename Predicate> xml_node find_node(Predicate pred) const
+		{
+			if (!_root) return xml_node();
+
+			xml_node cur = first_child();
+
+			while (cur._root && cur._root != _root)
+			{
+				if (pred(cur)) return cur;
+
+				if (cur.first_child()) cur = cur.first_child();
+				else if (cur.next_sibling()) cur = cur.next_sibling();
+				else
+				{
+					while (!cur.next_sibling() && cur._root != _root) cur = cur.parent();
+
+					if (cur._root != _root) cur = cur.next_sibling();
+				}
+			}
+
+			return xml_node();
+		}
+
+		// Find child node by attribute name/value
+		xml_node find_child_by_attribute(const char_t* name, const char_t* attr_name, const char_t* attr_value) const;
+		xml_node find_child_by_attribute(const char_t* attr_name, const char_t* attr_value) const;
+
+	#ifndef PUGIXML_NO_STL
+		// Get the absolute node path from root as a text string.
+		string_t path(char_t delimiter = '/') const;
+	#endif
+
+		// Search for a node by path consisting of node names and . or .. elements.
+		xml_node first_element_by_path(const char_t* path, char_t delimiter = '/') const;
+
+		// Recursively traverse subtree with xml_tree_walker
+		bool traverse(xml_tree_walker& walker);
+
+	#ifndef PUGIXML_NO_XPATH
+		// Select single node by evaluating XPath query. Returns first node from the resulting node set.
+		xpath_node select_node(const char_t* query, xpath_variable_set* variables = PUGIXML_NULL) const;
+		xpath_node select_node(const xpath_query& query) const;
+
+		// Select node set by evaluating XPath query
+		xpath_node_set select_nodes(const char_t* query, xpath_variable_set* variables = PUGIXML_NULL) const;
+		xpath_node_set select_nodes(const xpath_query& query) const;
+
+		// (deprecated: use select_node instead) Select single node by evaluating XPath query.
+		PUGIXML_DEPRECATED xpath_node select_single_node(const char_t* query, xpath_variable_set* variables = PUGIXML_NULL) const;
+		PUGIXML_DEPRECATED xpath_node select_single_node(const xpath_query& query) const;
+
+	#endif
+
+		// Print subtree using a writer object
+		void print(xml_writer& writer, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto, unsigned int depth = 0) const;
+
+	#ifndef PUGIXML_NO_STL
+		// Print subtree to stream
+		void print(std::basic_ostream<char, std::char_traits<char> >& os, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto, unsigned int depth = 0) const;
+		void print(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& os, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, unsigned int depth = 0) const;
+	#endif
+
+		// Child nodes iterators
+		typedef xml_node_iterator iterator;
+
+		iterator begin() const;
+		iterator end() const;
+
+		// Attribute iterators
+		typedef xml_attribute_iterator attribute_iterator;
+
+		attribute_iterator attributes_begin() const;
+		attribute_iterator attributes_end() const;
+
+		// Range-based for support
+		xml_object_range<xml_node_iterator> children() const;
+		xml_object_range<xml_attribute_iterator> attributes() const;
+
+		// Range-based for support for all children with the specified name
+		// Note: name pointer must have a longer lifetime than the returned object; be careful with passing temporaries!
+		xml_object_range<xml_named_node_iterator> children(const char_t* name) const;
+
+		// Get node offset in parsed file/string (in char_t units) for debugging purposes
+		ptrdiff_t offset_debug() const;
+
+		// Get hash value (unique for handles to the same object)
+		size_t hash_value() const;
+
+		// Get internal pointer
+		xml_node_struct* internal_object() const;
+	};
+
+#ifdef __BORLANDC__
+	// Borland C++ workaround
+	bool PUGIXML_FUNCTION operator&&(const xml_node& lhs, bool rhs);
+	bool PUGIXML_FUNCTION operator||(const xml_node& lhs, bool rhs);
+#endif
+
+	// A helper for working with text inside PCDATA nodes
+	class PUGIXML_CLASS xml_text
+	{
+		friend class xml_node;
+
+		xml_node_struct* _root;
+
+		typedef void (*unspecified_bool_type)(xml_text***);
+
+		explicit xml_text(xml_node_struct* root);
+
+		xml_node_struct* _data_new();
+		xml_node_struct* _data() const;
+
+	public:
+		// Default constructor. Constructs an empty object.
+		xml_text();
+
+		// Safe bool conversion operator
+		operator unspecified_bool_type() const;
+
+		// Borland C++ workaround
+		bool operator!() const;
+
+		// Check if text object is empty
+		bool empty() const;
+
+		// Get text, or "" if object is empty
+		const char_t* get() const;
+
+		// Get text, or the default value if object is empty
+		const char_t* as_string(const char_t* def = PUGIXML_TEXT("")) const;
+
+		// Get text as a number, or the default value if conversion did not succeed or object is empty
+		int as_int(int def = 0) const;
+		unsigned int as_uint(unsigned int def = 0) const;
+		double as_double(double def = 0) const;
+		float as_float(float def = 0) const;
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		long long as_llong(long long def = 0) const;
+		unsigned long long as_ullong(unsigned long long def = 0) const;
+	#endif
+
+		// Get text as bool (returns true if first character is in '1tTyY' set), or the default value if object is empty
+		bool as_bool(bool def = false) const;
+
+		// Set text (returns false if object is empty or there is not enough memory)
+		bool set(const char_t* rhs);
+		bool set(const char_t* rhs, size_t size);
+
+		// Set text with type conversion (numbers are converted to strings, boolean is converted to "true"/"false")
+		bool set(int rhs);
+		bool set(unsigned int rhs);
+		bool set(long rhs);
+		bool set(unsigned long rhs);
+		bool set(double rhs);
+		bool set(double rhs, int precision);
+		bool set(float rhs);
+		bool set(float rhs, int precision);
+		bool set(bool rhs);
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		bool set(long long rhs);
+		bool set(unsigned long long rhs);
+	#endif
+
+		// Set text (equivalent to set without error checking)
+		xml_text& operator=(const char_t* rhs);
+		xml_text& operator=(int rhs);
+		xml_text& operator=(unsigned int rhs);
+		xml_text& operator=(long rhs);
+		xml_text& operator=(unsigned long rhs);
+		xml_text& operator=(double rhs);
+		xml_text& operator=(float rhs);
+		xml_text& operator=(bool rhs);
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		xml_text& operator=(long long rhs);
+		xml_text& operator=(unsigned long long rhs);
+	#endif
+
+		// Get the data node (node_pcdata or node_cdata) for this object
+		xml_node data() const;
+	};
+
+#ifdef __BORLANDC__
+	// Borland C++ workaround
+	bool PUGIXML_FUNCTION operator&&(const xml_text& lhs, bool rhs);
+	bool PUGIXML_FUNCTION operator||(const xml_text& lhs, bool rhs);
+#endif
+
+	// Child node iterator (a bidirectional iterator over a collection of xml_node)
+	class PUGIXML_CLASS xml_node_iterator
+	{
+		friend class xml_node;
+
+	private:
+		mutable xml_node _wrap;
+		xml_node _parent;
+
+		xml_node_iterator(xml_node_struct* ref, xml_node_struct* parent);
+
+	public:
+		// Iterator traits
+		typedef ptrdiff_t difference_type;
+		typedef xml_node value_type;
+		typedef xml_node* pointer;
+		typedef xml_node& reference;
+
+	#ifndef PUGIXML_NO_STL
+		typedef std::bidirectional_iterator_tag iterator_category;
+	#endif
+
+		// Default constructor
+		xml_node_iterator();
+
+		// Construct an iterator which points to the specified node
+		xml_node_iterator(const xml_node& node);
+
+		// Iterator operators
+		bool operator==(const xml_node_iterator& rhs) const;
+		bool operator!=(const xml_node_iterator& rhs) const;
+
+		xml_node& operator*() const;
+		xml_node* operator->() const;
+
+		xml_node_iterator& operator++();
+		xml_node_iterator operator++(int);
+
+		xml_node_iterator& operator--();
+		xml_node_iterator operator--(int);
+	};
+
+	// Attribute iterator (a bidirectional iterator over a collection of xml_attribute)
+	class PUGIXML_CLASS xml_attribute_iterator
+	{
+		friend class xml_node;
+
+	private:
+		mutable xml_attribute _wrap;
+		xml_node _parent;
+
+		xml_attribute_iterator(xml_attribute_struct* ref, xml_node_struct* parent);
+
+	public:
+		// Iterator traits
+		typedef ptrdiff_t difference_type;
+		typedef xml_attribute value_type;
+		typedef xml_attribute* pointer;
+		typedef xml_attribute& reference;
+
+	#ifndef PUGIXML_NO_STL
+		typedef std::bidirectional_iterator_tag iterator_category;
+	#endif
+
+		// Default constructor
+		xml_attribute_iterator();
+
+		// Construct an iterator which points to the specified attribute
+		xml_attribute_iterator(const xml_attribute& attr, const xml_node& parent);
+
+		// Iterator operators
+		bool operator==(const xml_attribute_iterator& rhs) const;
+		bool operator!=(const xml_attribute_iterator& rhs) const;
+
+		xml_attribute& operator*() const;
+		xml_attribute* operator->() const;
+
+		xml_attribute_iterator& operator++();
+		xml_attribute_iterator operator++(int);
+
+		xml_attribute_iterator& operator--();
+		xml_attribute_iterator operator--(int);
+	};
+
+	// Named node range helper
+	class PUGIXML_CLASS xml_named_node_iterator
+	{
+		friend class xml_node;
+
+	public:
+		// Iterator traits
+		typedef ptrdiff_t difference_type;
+		typedef xml_node value_type;
+		typedef xml_node* pointer;
+		typedef xml_node& reference;
+
+	#ifndef PUGIXML_NO_STL
+		typedef std::bidirectional_iterator_tag iterator_category;
+	#endif
+
+		// Default constructor
+		xml_named_node_iterator();
+
+		// Construct an iterator which points to the specified node
+		// Note: name pointer is stored in the iterator and must have a longer lifetime than iterator itself
+		xml_named_node_iterator(const xml_node& node, const char_t* name);
+
+		// Iterator operators
+		bool operator==(const xml_named_node_iterator& rhs) const;
+		bool operator!=(const xml_named_node_iterator& rhs) const;
+
+		xml_node& operator*() const;
+		xml_node* operator->() const;
+
+		xml_named_node_iterator& operator++();
+		xml_named_node_iterator operator++(int);
+
+		xml_named_node_iterator& operator--();
+		xml_named_node_iterator operator--(int);
+
+	private:
+		mutable xml_node _wrap;
+		xml_node _parent;
+		const char_t* _name;
+
+		xml_named_node_iterator(xml_node_struct* ref, xml_node_struct* parent, const char_t* name);
+	};
+
+	// Abstract tree walker class (see xml_node::traverse)
+	class PUGIXML_CLASS xml_tree_walker
+	{
+		friend class xml_node;
+
+	private:
+		int _depth;
+
+	protected:
+		// Get current traversal depth
+		int depth() const;
+
+	public:
+		xml_tree_walker();
+		virtual ~xml_tree_walker();
+
+		// Callback that is called when traversal begins
+		virtual bool begin(xml_node& node);
+
+		// Callback that is called for each node traversed
+		virtual bool for_each(xml_node& node) = 0;
+
+		// Callback that is called when traversal ends
+		virtual bool end(xml_node& node);
+	};
+
+	// Parsing status, returned as part of xml_parse_result object
+	enum xml_parse_status
+	{
+		status_ok = 0,				// No error
+
+		status_file_not_found,		// File was not found during load_file()
+		status_io_error,			// Error reading from file/stream
+		status_out_of_memory,		// Could not allocate memory
+		status_internal_error,		// Internal error occurred
+
+		status_unrecognized_tag,	// Parser could not determine tag type
+
+		status_bad_pi,				// Parsing error occurred while parsing document declaration/processing instruction
+		status_bad_comment,			// Parsing error occurred while parsing comment
+		status_bad_cdata,			// Parsing error occurred while parsing CDATA section
+		status_bad_doctype,			// Parsing error occurred while parsing document type declaration
+		status_bad_pcdata,			// Parsing error occurred while parsing PCDATA section
+		status_bad_start_element,	// Parsing error occurred while parsing start element tag
+		status_bad_attribute,		// Parsing error occurred while parsing element attribute
+		status_bad_end_element,		// Parsing error occurred while parsing end element tag
+		status_end_element_mismatch,// There was a mismatch of start-end tags (closing tag had incorrect name, some tag was not closed or there was an excessive closing tag)
+
+		status_append_invalid_root,	// Unable to append nodes since root type is not node_element or node_document (exclusive to xml_node::append_buffer)
+
+		status_no_document_element	// Parsing resulted in a document without element nodes
+	};
+
+	// Parsing result
+	struct PUGIXML_CLASS xml_parse_result
+	{
+		// Parsing status (see xml_parse_status)
+		xml_parse_status status;
+
+		// Last parsed offset (in char_t units from start of input data)
+		ptrdiff_t offset;
+
+		// Source document encoding
+		xml_encoding encoding;
+
+		// Default constructor, initializes object to failed state
+		xml_parse_result();
+
+		// Cast to bool operator
+		operator bool() const;
+
+		// Get error description
+		const char* description() const;
+	};
+
+	// Document class (DOM tree root)
+	class PUGIXML_CLASS xml_document: public xml_node
+	{
+	private:
+		char_t* _buffer;
+
+		char _memory[192];
+
+		// Non-copyable semantics
+		xml_document(const xml_document&);
+		xml_document& operator=(const xml_document&);
+
+		void _create();
+		void _destroy();
+		void _move(xml_document& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT;
+
+	public:
+		// Default constructor, makes empty document
+		xml_document();
+
+		// Destructor, invalidates all node/attribute handles to this document
+		~xml_document();
+
+	#ifdef PUGIXML_HAS_MOVE
+		// Move semantics support
+		xml_document(xml_document&& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT;
+		xml_document& operator=(xml_document&& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT;
+	#endif
+
+		// Removes all nodes, leaving the empty document
+		void reset();
+
+		// Removes all nodes, then copies the entire contents of the specified document
+		void reset(const xml_document& proto);
+
+	#ifndef PUGIXML_NO_STL
+		// Load document from stream.
+		xml_parse_result load(std::basic_istream<char, std::char_traits<char> >& stream, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+		xml_parse_result load(std::basic_istream<wchar_t, std::char_traits<wchar_t> >& stream, unsigned int options = parse_default);
+	#endif
+
+		// (deprecated: use load_string instead) Load document from zero-terminated string. No encoding conversions are applied.
+		PUGIXML_DEPRECATED xml_parse_result load(const char_t* contents, unsigned int options = parse_default);
+
+		// Load document from zero-terminated string. No encoding conversions are applied.
+		xml_parse_result load_string(const char_t* contents, unsigned int options = parse_default);
+
+		// Load document from file
+		xml_parse_result load_file(const char* path, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+		xml_parse_result load_file(const wchar_t* path, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+
+		// Load document from buffer. Copies/converts the buffer, so it may be deleted or changed after the function returns.
+		xml_parse_result load_buffer(const void* contents, size_t size, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+
+		// Load document from buffer, using the buffer for in-place parsing (the buffer is modified and used for storage of document data).
+		// You should ensure that buffer data will persist throughout the document's lifetime, and free the buffer memory manually once document is destroyed.
+		xml_parse_result load_buffer_inplace(void* contents, size_t size, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+
+		// Load document from buffer, using the buffer for in-place parsing (the buffer is modified and used for storage of document data).
+		// You should allocate the buffer with pugixml allocation function; document will free the buffer when it is no longer needed (you can't use it anymore).
+		xml_parse_result load_buffer_inplace_own(void* contents, size_t size, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+
+		// Save XML document to writer (semantics is slightly different from xml_node::print, see documentation for details).
+		void save(xml_writer& writer, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto) const;
+
+	#ifndef PUGIXML_NO_STL
+		// Save XML document to stream (semantics is slightly different from xml_node::print, see documentation for details).
+		void save(std::basic_ostream<char, std::char_traits<char> >& stream, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto) const;
+		void save(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& stream, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default) const;
+	#endif
+
+		// Save XML to file
+		bool save_file(const char* path, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto) const;
+		bool save_file(const wchar_t* path, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto) const;
+
+		// Get document element
+		xml_node document_element() const;
+	};
+
+#ifndef PUGIXML_NO_XPATH
+	// XPath query return type
+	enum xpath_value_type
+	{
+		xpath_type_none,	  // Unknown type (query failed to compile)
+		xpath_type_node_set,  // Node set (xpath_node_set)
+		xpath_type_number,	  // Number
+		xpath_type_string,	  // String
+		xpath_type_boolean	  // Boolean
+	};
+
+	// XPath parsing result
+	struct PUGIXML_CLASS xpath_parse_result
+	{
+		// Error message (0 if no error)
+		const char* error;
+
+		// Last parsed offset (in char_t units from string start)
+		ptrdiff_t offset;
+
+		// Default constructor, initializes object to failed state
+		xpath_parse_result();
+
+		// Cast to bool operator
+		operator bool() const;
+
+		// Get error description
+		const char* description() const;
+	};
+
+	// A single XPath variable
+	class PUGIXML_CLASS xpath_variable
+	{
+		friend class xpath_variable_set;
+
+	protected:
+		xpath_value_type _type;
+		xpath_variable* _next;
+
+		xpath_variable(xpath_value_type type);
+
+		// Non-copyable semantics
+		xpath_variable(const xpath_variable&);
+		xpath_variable& operator=(const xpath_variable&);
+
+	public:
+		// Get variable name
+		const char_t* name() const;
+
+		// Get variable type
+		xpath_value_type type() const;
+
+		// Get variable value; no type conversion is performed, default value (false, NaN, empty string, empty node set) is returned on type mismatch error
+		bool get_boolean() const;
+		double get_number() const;
+		const char_t* get_string() const;
+		const xpath_node_set& get_node_set() const;
+
+		// Set variable value; no type conversion is performed, false is returned on type mismatch error
+		bool set(bool value);
+		bool set(double value);
+		bool set(const char_t* value);
+		bool set(const xpath_node_set& value);
+	};
+
+	// A set of XPath variables
+	class PUGIXML_CLASS xpath_variable_set
+	{
+	private:
+		xpath_variable* _data[64];
+
+		void _assign(const xpath_variable_set& rhs);
+		void _swap(xpath_variable_set& rhs);
+
+		xpath_variable* _find(const char_t* name) const;
+
+		static bool _clone(xpath_variable* var, xpath_variable** out_result);
+		static void _destroy(xpath_variable* var);
+
+	public:
+		// Default constructor/destructor
+		xpath_variable_set();
+		~xpath_variable_set();
+
+		// Copy constructor/assignment operator
+		xpath_variable_set(const xpath_variable_set& rhs);
+		xpath_variable_set& operator=(const xpath_variable_set& rhs);
+
+	#ifdef PUGIXML_HAS_MOVE
+		// Move semantics support
+		xpath_variable_set(xpath_variable_set&& rhs) PUGIXML_NOEXCEPT;
+		xpath_variable_set& operator=(xpath_variable_set&& rhs) PUGIXML_NOEXCEPT;
+	#endif
+
+		// Add a new variable or get the existing one, if the types match
+		xpath_variable* add(const char_t* name, xpath_value_type type);
+
+		// Set value of an existing variable; no type conversion is performed, false is returned if there is no such variable or if types mismatch
+		bool set(const char_t* name, bool value);
+		bool set(const char_t* name, double value);
+		bool set(const char_t* name, const char_t* value);
+		bool set(const char_t* name, const xpath_node_set& value);
+
+		// Get existing variable by name
+		xpath_variable* get(const char_t* name);
+		const xpath_variable* get(const char_t* name) const;
+	};
+
+	// A compiled XPath query object
+	class PUGIXML_CLASS xpath_query
+	{
+	private:
+		void* _impl;
+		xpath_parse_result _result;
+
+		typedef void (*unspecified_bool_type)(xpath_query***);
+
+		// Non-copyable semantics
+		xpath_query(const xpath_query&);
+		xpath_query& operator=(const xpath_query&);
+
+	public:
+		// Construct a compiled object from XPath expression.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws xpath_exception on compilation errors.
+		explicit xpath_query(const char_t* query, xpath_variable_set* variables = PUGIXML_NULL);
+
+		// Constructor
+		xpath_query();
+
+		// Destructor
+		~xpath_query();
+
+	#ifdef PUGIXML_HAS_MOVE
+		// Move semantics support
+		xpath_query(xpath_query&& rhs) PUGIXML_NOEXCEPT;
+		xpath_query& operator=(xpath_query&& rhs) PUGIXML_NOEXCEPT;
+	#endif
+
+		// Get query expression return type
+		xpath_value_type return_type() const;
+
+		// Evaluate expression as boolean value in the specified context; performs type conversion if necessary.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws std::bad_alloc on out of memory errors.
+		bool evaluate_boolean(const xpath_node& n) const;
+
+		// Evaluate expression as double value in the specified context; performs type conversion if necessary.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws std::bad_alloc on out of memory errors.
+		double evaluate_number(const xpath_node& n) const;
+
+	#ifndef PUGIXML_NO_STL
+		// Evaluate expression as string value in the specified context; performs type conversion if necessary.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws std::bad_alloc on out of memory errors.
+		string_t evaluate_string(const xpath_node& n) const;
+	#endif
+
+		// Evaluate expression as string value in the specified context; performs type conversion if necessary.
+		// At most capacity characters are written to the destination buffer, full result size is returned (includes terminating zero).
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws std::bad_alloc on out of memory errors.
+		// If PUGIXML_NO_EXCEPTIONS is defined, returns empty  set instead.
+		size_t evaluate_string(char_t* buffer, size_t capacity, const xpath_node& n) const;
+
+		// Evaluate expression as node set in the specified context.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws xpath_exception on type mismatch and std::bad_alloc on out of memory errors.
+		// If PUGIXML_NO_EXCEPTIONS is defined, returns empty node set instead.
+		xpath_node_set evaluate_node_set(const xpath_node& n) const;
+
+		// Evaluate expression as node set in the specified context.
+		// Return first node in document order, or empty node if node set is empty.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws xpath_exception on type mismatch and std::bad_alloc on out of memory errors.
+		// If PUGIXML_NO_EXCEPTIONS is defined, returns empty node instead.
+		xpath_node evaluate_node(const xpath_node& n) const;
+
+		// Get parsing result (used to get compilation errors in PUGIXML_NO_EXCEPTIONS mode)
+		const xpath_parse_result& result() const;
+
+		// Safe bool conversion operator
+		operator unspecified_bool_type() const;
+
+		// Borland C++ workaround
+		bool operator!() const;
+	};
+
+	#ifndef PUGIXML_NO_EXCEPTIONS
+        #if defined(_MSC_VER)
+          // C4275 can be ignored in Visual C++ if you are deriving
+          // from a type in the Standard C++ Library
+          #pragma warning(push)
+          #pragma warning(disable: 4275)
+        #endif
+	// XPath exception class
+	class PUGIXML_CLASS xpath_exception: public std::exception
+	{
+	private:
+		xpath_parse_result _result;
+
+	public:
+		// Construct exception from parse result
+		explicit xpath_exception(const xpath_parse_result& result);
+
+		// Get error message
+		virtual const char* what() const throw() PUGIXML_OVERRIDE;
+
+		// Get parse result
+		const xpath_parse_result& result() const;
+	};
+        #if defined(_MSC_VER)
+          #pragma warning(pop)
+        #endif
+	#endif
+
+	// XPath node class (either xml_node or xml_attribute)
+	class PUGIXML_CLASS xpath_node
+	{
+	private:
+		xml_node _node;
+		xml_attribute _attribute;
+
+		typedef void (*unspecified_bool_type)(xpath_node***);
+
+	public:
+		// Default constructor; constructs empty XPath node
+		xpath_node();
+
+		// Construct XPath node from XML node/attribute
+		xpath_node(const xml_node& node);
+		xpath_node(const xml_attribute& attribute, const xml_node& parent);
+
+		// Get node/attribute, if any
+		xml_node node() const;
+		xml_attribute attribute() const;
+
+		// Get parent of contained node/attribute
+		xml_node parent() const;
+
+		// Safe bool conversion operator
+		operator unspecified_bool_type() const;
+
+		// Borland C++ workaround
+		bool operator!() const;
+
+		// Comparison operators
+		bool operator==(const xpath_node& n) const;
+		bool operator!=(const xpath_node& n) const;
+	};
+
+#ifdef __BORLANDC__
+	// Borland C++ workaround
+	bool PUGIXML_FUNCTION operator&&(const xpath_node& lhs, bool rhs);
+	bool PUGIXML_FUNCTION operator||(const xpath_node& lhs, bool rhs);
+#endif
+
+	// A fixed-size collection of XPath nodes
+	class PUGIXML_CLASS xpath_node_set
+	{
+	public:
+		// Collection type
+		enum type_t
+		{
+			type_unsorted,			// Not ordered
+			type_sorted,			// Sorted by document order (ascending)
+			type_sorted_reverse		// Sorted by document order (descending)
+		};
+
+		// Constant iterator type
+		typedef const xpath_node* const_iterator;
+
+		// We define non-constant iterator to be the same as constant iterator so that various generic algorithms (i.e. boost foreach) work
+		typedef const xpath_node* iterator;
+
+		// Default constructor. Constructs empty set.
+		xpath_node_set();
+
+		// Constructs a set from iterator range; data is not checked for duplicates and is not sorted according to provided type, so be careful
+		xpath_node_set(const_iterator begin, const_iterator end, type_t type = type_unsorted);
+
+		// Destructor
+		~xpath_node_set();
+
+		// Copy constructor/assignment operator
+		xpath_node_set(const xpath_node_set& ns);
+		xpath_node_set& operator=(const xpath_node_set& ns);
+
+	#ifdef PUGIXML_HAS_MOVE
+		// Move semantics support
+		xpath_node_set(xpath_node_set&& rhs) PUGIXML_NOEXCEPT;
+		xpath_node_set& operator=(xpath_node_set&& rhs) PUGIXML_NOEXCEPT;
+	#endif
+
+		// Get collection type
+		type_t type() const;
+
+		// Get collection size
+		size_t size() const;
+
+		// Indexing operator
+		const xpath_node& operator[](size_t index) const;
+
+		// Collection iterators
+		const_iterator begin() const;
+		const_iterator end() const;
+
+		// Sort the collection in ascending/descending order by document order
+		void sort(bool reverse = false);
+
+		// Get first node in the collection by document order
+		xpath_node first() const;
+
+		// Check if collection is empty
+		bool empty() const;
+
+	private:
+		type_t _type;
+
+		xpath_node _storage[1];
+
+		xpath_node* _begin;
+		xpath_node* _end;
+
+		void _assign(const_iterator begin, const_iterator end, type_t type);
+		void _move(xpath_node_set& rhs) PUGIXML_NOEXCEPT;
+	};
+#endif
+
+#ifndef PUGIXML_NO_STL
+	// Convert wide string to UTF8
+	std::basic_string<char, std::char_traits<char>, std::allocator<char> > PUGIXML_FUNCTION as_utf8(const wchar_t* str);
+	std::basic_string<char, std::char_traits<char>, std::allocator<char> > PUGIXML_FUNCTION as_utf8(const std::basic_string<wchar_t, std::char_traits<wchar_t>, std::allocator<wchar_t> >& str);
+
+	// Convert UTF8 to wide string
+	std::basic_string<wchar_t, std::char_traits<wchar_t>, std::allocator<wchar_t> > PUGIXML_FUNCTION as_wide(const char* str);
+	std::basic_string<wchar_t, std::char_traits<wchar_t>, std::allocator<wchar_t> > PUGIXML_FUNCTION as_wide(const std::basic_string<char, std::char_traits<char>, std::allocator<char> >& str);
+#endif
+
+	// Memory allocation function interface; returns pointer to allocated memory or NULL on failure
+	typedef void* (*allocation_function)(size_t size);
+
+	// Memory deallocation function interface
+	typedef void (*deallocation_function)(void* ptr);
+
+	// Override default memory management functions. All subsequent allocations/deallocations will be performed via supplied functions.
+	void PUGIXML_FUNCTION set_memory_management_functions(allocation_function allocate, deallocation_function deallocate);
+
+	// Get current memory management functions
+	allocation_function PUGIXML_FUNCTION get_memory_allocation_function();
+	deallocation_function PUGIXML_FUNCTION get_memory_deallocation_function();
+}
+
+#if !defined(PUGIXML_NO_STL) && (defined(_MSC_VER) || defined(__ICC))
+namespace std
+{
+	// Workarounds for (non-standard) iterator category detection for older versions (MSVC7/IC8 and earlier)
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION _Iter_cat(const pugi::xml_node_iterator&);
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION _Iter_cat(const pugi::xml_attribute_iterator&);
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION _Iter_cat(const pugi::xml_named_node_iterator&);
+}
+#endif
+
+#if !defined(PUGIXML_NO_STL) && defined(__SUNPRO_CC)
+namespace std
+{
+	// Workarounds for (non-standard) iterator category detection
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION __iterator_category(const pugi::xml_node_iterator&);
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION __iterator_category(const pugi::xml_attribute_iterator&);
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION __iterator_category(const pugi::xml_named_node_iterator&);
+}
+#endif
+
+#endif
+
+// Make sure implementation is included in header-only mode
+// Use macro expansion in #include to work around QMake (QTBUG-11923)
+#if defined(PUGIXML_HEADER_ONLY) && !defined(PUGIXML_SOURCE)
+#	define PUGIXML_SOURCE "pugixml.cpp"
+#	include PUGIXML_SOURCE
+#endif
+
+/**
+ * Copyright (c) 2006-2023 Arseny Kapoulkine
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */

+ 371 - 0
pico-tcp-service/pico-tcp-client/simplelogger.cpp

@@ -0,0 +1,371 @@
+#include "simplelogger.hpp"
+
+// Generates filename (in format prefix-log-data-time)
+
+std::string SimpleLogger::generateFileName()
+{
+    std::chrono::time_point<std::chrono::system_clock> time_now = std::chrono::system_clock::now();
+    std::time_t t_n = std::chrono::system_clock::to_time_t(time_now);
+
+    char logfile_creation_time[100];
+    std::strftime(logfile_creation_time, sizeof(logfile_creation_time), "%Y%m%d-%H%M%S", std::localtime(&t_n));
+    std::string logname = this->log_name_prefix + "-log-" + std::string(logfile_creation_time) + ".log";
+
+    std::cout << logname << std::endl;
+
+    return logname;
+}
+
+// Generates prefix (in format of [TIME] / [FLAG]) for log string
+
+std::string SimpleLogger::generateLogString(int flag = INFO)
+{
+    auto time = std::chrono::system_clock::now(); // get the current time
+    std::time_t t = std::chrono::system_clock::to_time_t(time);
+
+    char log_time[100];
+    std::strftime(log_time, sizeof(log_time), "%Y-%m-%d %H:%M:%S", std::localtime(&t));
+
+    auto since_epoch = time.time_since_epoch(); // get the duration since epoch
+
+    auto time_millis = std::chrono::duration_cast<std::chrono::milliseconds>(since_epoch);
+    auto time_seconds = std::chrono::duration_cast<std::chrono::seconds>(since_epoch);
+
+    unsigned long long millis = time_millis.count() - 1000*time_seconds.count();
+
+    std::string logstring = std::string("[") + std::string(log_time) + std::string(":") + std::to_string(millis) + std::string("]");
+
+    // Different flags
+    switch(flag)
+    {
+    case ERROR:
+        logstring = logstring + " / [ERROR]\t";
+        break;
+    case DEBUG_ERROR:
+        logstring = logstring + " / [ERROR]\t";
+        break;
+    case DONE:
+        logstring = logstring + " / [DONE]\t";
+        break;
+    case WARN:
+        logstring = logstring + " / [WARN]\t";
+        break;
+    case INFO:
+        logstring = logstring + " / [INFO]\t";
+        break;
+    case OK:
+        logstring = logstring + " / [OK]\t";
+        break;
+    case DEBUG:
+        logstring = logstring + " / [DEBUG]\t";
+        break;
+    default:
+        logstring = logstring + " / [UNDEF]\t";
+        break;
+    }
+
+    return logstring;
+}
+
+// Main Constructors (we need to send reference to our main log stream)
+
+SimpleLogger::SimpleLogger(std::ostream& ls = std::cout, std::string prefix = "", std::string dir = "") : log_stream(ls)
+{
+    this->initializeLogger(dir, prefix);
+}
+
+SimpleLogger::SimpleLogger(std::ostream& ls = std::cout) : log_stream(ls)
+{
+    this->initializeLogger("", "some");
+}
+
+SimpleLogger::SimpleLogger(std::ostream& ls, std::string prefix) : log_stream(ls)
+{
+    this->initializeLogger("", prefix);
+}
+
+// Initialize function
+
+void SimpleLogger::initializeLogger(std::string dir = "", std::string prefix = "")
+{
+    this->log_flag.flag = INFO;
+
+    if(dir != "")
+    {
+    #ifdef _WIN32
+    CreateDirectoryA(dir.c_str(), NULL);
+    this->log_name_prefix = dir + std::string("\\") + prefix;
+    #endif // _WIN32
+
+    #if defined(_LINUX)
+    mkdir(dir.c_str(), 0777);
+    this->log_name_prefix = dir + std::string("/") +prefix;
+    #endif // defined
+    }
+    else
+    {
+        this->log_name_prefix = prefix;
+    }
+
+    this->log_string = "";
+    this->console_enabled = false;
+
+    this->log_name = generateFileName();
+
+    this->file_stream.open(this->log_name);
+    this->log_stream.rdbuf(this->file_stream.rdbuf());
+}
+
+// Copy logger constructor
+
+SimpleLogger::SimpleLogger(const SimpleLogger& other) : log_stream(other.log_stream)
+{
+    this->log_flag = other.log_flag;
+    this->log_name_prefix = other.log_name_prefix;
+    this->log_string = other.log_string;
+    this->console_enabled = other.console_enabled;
+    this->log_name = other.log_name;
+}
+
+// Close logger stream
+
+void SimpleLogger::closeLogger()
+{
+    this->file_stream.close();
+}
+
+// Destructor
+
+SimpleLogger::~SimpleLogger()
+{
+    this->closeLogger();
+}
+
+// Setting logger flag
+
+void SimpleLogger::setLoggerFlag(LogPref::Flag log_flag = LogPref::Flag(INFO))
+{
+    this->log_flag = log_flag;
+}
+
+// Setting ability to console output
+
+void SimpleLogger::enableConsoleOutput(bool enable_console)
+{
+    console_enabled = enable_console;
+}
+
+// Sets flag just for one record;
+
+SimpleLogger SimpleLogger::operator<<(LogPref::Flag flag)
+{
+    SimpleLogger s(*this);
+    s.setLoggerFlag(flag);
+    return s;
+}
+
+// Shift operators (follow standard ostream shift operators)
+
+SimpleLogger SimpleLogger::operator<<(bool val){
+    // Firstly printing in console
+    if(console_enabled){
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    // Printing in file
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned long long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(double val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long double val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const void* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::nullptr_t) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << "nullptr";
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << "nullptr";
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(short val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(int val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned short val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned int val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(float val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::streambuf *sb) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << sb;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << sb;;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::ios_base& (*func)(std::ios_base&)) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::ostream& (*func)(std::ostream&)) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::_Setfill<char> func)
+{
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::_Setw func)
+{
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::string val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const signed char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const unsigned char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const char val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const unsigned char val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}

+ 100 - 0
pico-tcp-service/pico-tcp-client/simplelogger.hpp

@@ -0,0 +1,100 @@
+#include <iostream>
+#include <iomanip>
+#include <chrono>
+#include <ctime>
+#include <sstream>
+#include <fstream>
+#include <sstream>
+#include <fstream>
+
+#if _WIN32
+
+#include <windows.h>
+#include <winbase.h>
+
+#endif // _WIN32
+
+#if defined(_LINUX)
+
+#include <sys/stat.h>
+#include <unistd.h>
+
+#endif // defined
+
+#define ERROR -1 // Logger flags
+#define DEBUG_ERROR 6
+#define WARN 1
+#define INFO 0
+#define OK 4
+#define DEBUG 7
+#define DONE 10
+#define NO_LOG_STRING 2
+
+#ifndef SIMPLELOGGER_HPP
+#define SIMPLELOGGER_HPP
+
+namespace LogPref
+{
+class Flag {
+public:
+    int flag;
+    Flag(int flag) {this->flag = flag;}
+    Flag() {this->flag = INFO;}
+};
+}
+
+class SimpleLogger {
+
+protected:
+    std::ostream& log_stream;
+    std::ofstream file_stream;
+
+    std::string log_name;
+    std::string log_name_prefix;
+    std::string log_string;
+    LogPref::Flag log_flag;
+    bool console_enabled;
+
+    std::string generateFileName();
+    std::string generateLogString(int flag);
+
+public:
+    SimpleLogger(std::ostream& ls, std::string prefix, std::string dir);
+    SimpleLogger(std::ostream& ls, std::string prefix);
+    SimpleLogger(std::ostream& ls);
+    SimpleLogger(const SimpleLogger& other);
+    void initializeLogger(std::string filename, std::string prefix);
+    void closeLogger();
+    void enableConsoleOutput(bool enable_console);
+    void setLoggerFlag(LogPref::Flag log_flag);
+    ~SimpleLogger();
+
+    SimpleLogger operator<<(LogPref::Flag flag);
+    SimpleLogger operator<<(bool val);
+    SimpleLogger operator<<(long val);
+    SimpleLogger operator<<(unsigned long val);
+    SimpleLogger operator<<(long long val);
+    SimpleLogger operator<<(unsigned long long val);
+    SimpleLogger operator<<(double val);
+    SimpleLogger operator<<(long double val);
+    SimpleLogger operator<<(const void* val);
+    SimpleLogger operator<<(std::nullptr_t);
+    SimpleLogger operator<<(short val);
+    SimpleLogger operator<<(int val);
+    SimpleLogger operator<<(unsigned short val);
+    SimpleLogger operator<<(unsigned int val);
+    SimpleLogger operator<<(float val);
+    SimpleLogger operator<<(std::streambuf *sb);
+    SimpleLogger operator<<(std::ios_base& (*func)(std::ios_base&));
+    SimpleLogger operator<<(std::ostream& (*func)(std::ostream&));
+    SimpleLogger operator<<(std::_Setfill<char> func);
+    SimpleLogger operator<<(std::_Setw func);
+    SimpleLogger operator<<(std::string val);
+    SimpleLogger operator<<(const char* val);
+    SimpleLogger operator<<(const signed char* val);
+    SimpleLogger operator<<(const unsigned char* val);
+    SimpleLogger operator<<(const char val);
+    SimpleLogger operator<<(const unsigned char val);
+};
+
+#endif // SIMPLELOGGER_HPP

+ 310 - 0
pico-tcp-service/pico-tcp-client/src/ActiveSocket.cpp

@@ -0,0 +1,310 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* CActiveSocket.cpp - Active Socket Implementation                          */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#include "ActiveSocket.h"
+
+CActiveSocket::CActiveSocket(CSocketType nType) : CSimpleSocket(nType)
+{
+}
+
+//------------------------------------------------------------------------------
+//
+// ConnectTCP() -
+//
+//------------------------------------------------------------------------------
+bool CActiveSocket::ConnectTCP(const char *pAddr, uint16 nPort)
+{
+    bool           bRetVal = false;
+    struct in_addr stIpAddress;
+
+    //------------------------------------------------------------------
+    // Preconnection setup that must be preformed
+    //------------------------------------------------------------------
+    memset(&m_stServerSockaddr, 0, sizeof(m_stServerSockaddr));
+    m_stServerSockaddr.sin_family = AF_INET;
+
+    if ((m_pHE = GETHOSTBYNAME(pAddr)) == NULL)
+    {
+#ifdef WIN32
+        TranslateSocketError();
+#else
+        if (h_errno == HOST_NOT_FOUND)
+        {
+            SetSocketError(SocketInvalidAddress);
+        }
+#endif
+        return bRetVal;
+    }
+
+    memcpy(&stIpAddress, m_pHE->h_addr_list[0], m_pHE->h_length);
+    m_stServerSockaddr.sin_addr.s_addr = stIpAddress.s_addr;
+
+    if ((int32)m_stServerSockaddr.sin_addr.s_addr == CSimpleSocket::SocketError)
+    {
+        TranslateSocketError();
+        return bRetVal;
+    }
+
+    m_stServerSockaddr.sin_port = htons(nPort);
+
+    //------------------------------------------------------------------
+    // Connect to address "xxx.xxx.xxx.xxx"    (IPv4) address only.
+    //
+    //------------------------------------------------------------------
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+    if (connect(m_socket, (struct sockaddr*)&m_stServerSockaddr, sizeof(m_stServerSockaddr)) ==
+            CSimpleSocket::SocketError)
+    {
+        //--------------------------------------------------------------
+        // Get error value this might be a non-blocking socket so we
+        // must first check.
+        //--------------------------------------------------------------
+        TranslateSocketError();
+
+        //--------------------------------------------------------------
+        // If the socket is non-blocking and the current socket error
+        // is SocketEinprogress or SocketEwouldblock then poll connection
+        // with select for designated timeout period.
+        // Linux returns EINPROGRESS and Windows returns WSAEWOULDBLOCK.
+        //--------------------------------------------------------------
+        if ((IsNonblocking()) &&
+                ((GetSocketError() == CSimpleSocket::SocketEwouldblock) ||
+                 (GetSocketError() == CSimpleSocket::SocketEinprogress)))
+        {
+            bRetVal = Select(GetConnectTimeoutSec(), GetConnectTimeoutUSec());
+        }
+    }
+    else
+    {
+        TranslateSocketError();
+        bRetVal = true;
+    }
+
+    m_timer.SetEndTime();
+
+    return bRetVal;
+}
+
+//------------------------------------------------------------------------------
+//
+// ConnectUDP() -
+//
+//------------------------------------------------------------------------------
+bool CActiveSocket::ConnectUDP(const char *pAddr, uint16 nPort)
+{
+    bool           bRetVal = false;
+    struct in_addr stIpAddress;
+
+    //------------------------------------------------------------------
+    // Pre-connection setup that must be preformed
+    //------------------------------------------------------------------
+    memset(&m_stServerSockaddr, 0, sizeof(m_stServerSockaddr));
+    m_stServerSockaddr.sin_family = AF_INET;
+
+    if ((m_pHE = GETHOSTBYNAME(pAddr)) == NULL)
+    {
+#ifdef WIN32
+        TranslateSocketError();
+#else
+        if (h_errno == HOST_NOT_FOUND)
+        {
+            SetSocketError(SocketInvalidAddress);
+        }
+#endif
+        return bRetVal;
+    }
+
+    memcpy(&stIpAddress, m_pHE->h_addr_list[0], m_pHE->h_length);
+    m_stServerSockaddr.sin_addr.s_addr = stIpAddress.s_addr;
+
+    if ((int32)m_stServerSockaddr.sin_addr.s_addr == CSimpleSocket::SocketError)
+    {
+        TranslateSocketError();
+        return bRetVal;
+    }
+
+    m_stServerSockaddr.sin_port = htons(nPort);
+
+    //------------------------------------------------------------------
+    // Connect to address "xxx.xxx.xxx.xxx"    (IPv4) address only.
+    //
+    //------------------------------------------------------------------
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+    if (connect(m_socket, (struct sockaddr*)&m_stServerSockaddr, sizeof(m_stServerSockaddr)) != CSimpleSocket::SocketError)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    m_timer.SetEndTime();
+
+    return bRetVal;
+}
+
+//------------------------------------------------------------------------------
+//
+// ConnectRAW() -
+//
+//------------------------------------------------------------------------------
+bool CActiveSocket::ConnectRAW(const char *pAddr, uint16 nPort)
+{
+    bool           bRetVal = false;
+    struct in_addr stIpAddress;
+    //------------------------------------------------------------------
+    // Pre-connection setup that must be preformed
+    //------------------------------------------------------------------
+    memset(&m_stServerSockaddr, 0, sizeof(m_stServerSockaddr));
+    m_stServerSockaddr.sin_family = AF_INET;
+
+    if ((m_pHE = GETHOSTBYNAME(pAddr)) == NULL)
+    {
+#ifdef WIN32
+        TranslateSocketError();
+#else
+        if (h_errno == HOST_NOT_FOUND)
+        {
+            SetSocketError(SocketInvalidAddress);
+        }
+#endif
+        return bRetVal;
+    }
+
+    memcpy(&stIpAddress, m_pHE->h_addr_list[0], m_pHE->h_length);
+    m_stServerSockaddr.sin_addr.s_addr = stIpAddress.s_addr;
+
+    if ((int32)m_stServerSockaddr.sin_addr.s_addr == CSimpleSocket::SocketError)
+    {
+        TranslateSocketError();
+        return bRetVal;
+    }
+
+    m_stServerSockaddr.sin_port = htons(nPort);
+
+    //------------------------------------------------------------------
+    // Connect to address "xxx.xxx.xxx.xxx"    (IPv4) address only.
+    //
+    //------------------------------------------------------------------
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+    if (connect(m_socket, (struct sockaddr*)&m_stServerSockaddr, sizeof(m_stServerSockaddr)) != CSimpleSocket::SocketError)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    m_timer.SetEndTime();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Open() - Create a connection to a specified address on a specified port
+//
+//------------------------------------------------------------------------------
+bool CActiveSocket::Open(const char *pAddr, uint16 nPort)
+{
+    bool bRetVal = false;
+
+    if (IsSocketValid() == false)
+    {
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+        return bRetVal;
+    }
+
+    if (pAddr == NULL)
+    {
+        SetSocketError(CSimpleSocket::SocketInvalidAddress);
+        return bRetVal;
+    }
+
+    if (nPort == 0)
+    {
+        SetSocketError(CSimpleSocket::SocketInvalidPort);
+        return bRetVal;
+    }
+
+    switch (m_nSocketType)
+    {
+    case CSimpleSocket::SocketTypeTcp :
+    {
+        bRetVal = ConnectTCP(pAddr, nPort);
+        break;
+    }
+    case CSimpleSocket::SocketTypeUdp :
+    {
+        bRetVal = ConnectUDP(pAddr, nPort);
+        break;
+    }
+    case CSimpleSocket::SocketTypeRaw :
+        break;
+    default:
+        break;
+    }
+
+    //--------------------------------------------------------------------------
+    // If successful then create a local copy of the address and port
+    //--------------------------------------------------------------------------
+    if (bRetVal)
+    {
+        socklen_t nSockLen = sizeof(struct sockaddr);
+
+        memset(&m_stServerSockaddr, 0, nSockLen);
+        getpeername(m_socket, (struct sockaddr *)&m_stServerSockaddr, &nSockLen);
+
+        nSockLen = sizeof(struct sockaddr);
+        memset(&m_stClientSockaddr, 0, nSockLen);
+        getsockname(m_socket, (struct sockaddr *)&m_stClientSockaddr, &nSockLen);
+
+        SetSocketError(SocketSuccess);
+    }
+
+    return bRetVal;
+}

+ 91 - 0
pico-tcp-service/pico-tcp-client/src/ActiveSocket.h

@@ -0,0 +1,91 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* ActiveSocket.h - Active Socket Decleration                                */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#ifndef __ACTIVESOCKET_H__
+#define __ACTIVESOCKET_H__
+
+#include "SimpleSocket.h"
+
+class CPassiveSocket;
+
+/// Provides a platform independent class to create an active socket.
+/// An active socket is used to create a socket which connects to a server.
+/// This type of object would be used when an application needs to send/receive
+/// data from a server.
+class EXPORT CActiveSocket : public CSimpleSocket {
+public:
+    friend class CPassiveSocket;
+
+    CActiveSocket(CSocketType type = SocketTypeTcp);
+    virtual ~CActiveSocket() {
+        Close();
+    };
+
+    /// Established a connection to the address specified by pAddr.
+    /// Connection-based protocol sockets (CSocket::SocketTypeTcp) may
+    /// successfully call Open() only once, however; connectionless protocol
+    /// sockets (CSocket::SocketTypeUdp) may use Open() multiple times to
+    /// change their association.
+    ///  @param pAddr specifies the destination address to connect.
+    ///  @param nPort specifies the destination port.
+    ///  @return true if successful connection made, otherwise false.
+    virtual bool Open(const char *pAddr, uint16 nPort);
+
+private:
+    /// Utility function used to create a TCP connection, called from Open().
+    ///  @return true if successful connection made, otherwise false.
+    bool ConnectTCP(const char *pAddr, uint16 nPort);
+
+    /// Utility function used to create a UDP connection, called from Open().
+    ///  @return true if successful connection made, otherwise false.
+    bool ConnectUDP(const char *pAddr, uint16 nPort);
+
+    /// Utility function used to create a RAW connection, called from Open().
+    ///  @return true if successful connection made, otherwise false.
+    bool ConnectRAW(const char *pAddr, uint16 nPort);
+
+private:
+    struct hostent *m_pHE;
+};
+
+#endif /*  __ACTIVESOCKET_H__  */
+

+ 263 - 0
pico-tcp-service/pico-tcp-client/src/Host.h

@@ -0,0 +1,263 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* Host.h - Basic header file to provide cross-platform solutions via        */
+/*                   macros, conditional compilation, etc.                   */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#ifndef __HOST_H__
+#define __HOST_H__
+
+#include <limits.h>
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* Type Definition Macros                                                    */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+#ifndef __WORDSIZE
+  /* Assume 32 */
+  #define __WORDSIZE 32
+#endif
+
+#if defined(_LINUX) || defined(_DARWIN)
+    typedef unsigned char  uint8;
+    typedef char           int8;
+    typedef unsigned short uint16;
+    typedef short          int16;
+    typedef unsigned int   uint32;
+    typedef int            int32;
+    typedef int            SOCKET;
+#endif
+
+#ifdef WIN32
+    struct iovec {
+        void  *iov_base;
+        size_t iov_len;
+    };
+
+    typedef unsigned char  uint8;
+    typedef char           int8;
+    typedef unsigned short uint16;
+    typedef short          int16;
+    typedef unsigned int   uint32;
+    typedef int            int32;
+#endif
+
+#ifdef WIN32
+    typedef int socklen_t;
+#endif
+
+#if defined(WIN32)
+    typedef unsigned long long int uint64;
+    typedef long long int          int64;
+#elif (__WORDSIZE == 32)
+    __extension__
+    typedef long long int          int64;
+    __extension__
+    typedef unsigned long long int uint64;
+#elif (__WORDSIZE == 64)
+    typedef unsigned long int uint64;
+    typedef long int          int64;
+#endif
+
+#ifdef WIN32
+
+  #ifndef UINT8_MAX
+    #define UINT8_MAX  (UCHAR_MAX)
+  #endif
+  #ifndef UINT16_MAX
+    #define UINT16_MAX (USHRT_MAX)
+  #endif
+  #ifndef UINT32_MAX
+    #define UINT32_MAX (ULONG_MAX)
+  #endif
+
+  #if __WORDSIZE == 64
+    #define SIZE_MAX (18446744073709551615UL)
+  #else
+    #ifndef SIZE_MAX
+    #define SIZE_MAX (4294967295U)
+  #endif
+  #endif
+#endif
+
+#if defined(WIN32)
+  #define ssize_t size_t
+#endif
+
+#ifndef TRUE
+  #define TRUE 1
+#endif
+
+#ifndef FALSE
+  #define FALSE 0
+#endif
+
+#ifndef htonll
+#ifdef _BIG_ENDIAN
+#define htonll(x)   (x)
+#define ntohll(x)   (x)
+#else
+#define htonll(x)   ((((uint64)htonl(x)) << 32) + htonl(x >> 32))
+#define ntohll(x)   ((((uint64)ntohl(x)) << 32) + ntohl(x >> 32))
+#endif
+#endif
+
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* Socket Macros                                                             */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+#ifdef WIN32
+#define SHUT_RD                0
+#define SHUT_WR                1
+#define SHUT_RDWR              2
+#define ACCEPT(a,b,c)          accept(a,b,c)
+#define CONNECT(a,b,c)         connect(a,b,c)
+#define CLOSE(a)               closesocket(a)
+#define READ(a,b,c)            read(a,b,c)
+#define RECV(a,b,c,d)          recv(a, (char *)b, c, d)
+#define RECVFROM(a,b,c,d,e,f)  recvfrom(a, (char *)b, c, d, (sockaddr *)e, (int *)f)
+#define RECV_FLAGS             MSG_WAITALL
+#define SELECT(a,b,c,d,e)      select((int32)a,b,c,d,e)
+#define SEND(a,b,c,d)          send(a, (const char *)b, (int)c, d)
+#define SENDTO(a,b,c,d,e,f)    sendto(a, (const char *)b, (int)c, d, e, f)
+#define SEND_FLAGS             0
+#define SENDFILE(a,b,c,d)      sendfile(a, b, c, d)
+#define SET_SOCKET_ERROR(x,y)  errno=y
+#define SOCKET_ERROR_INTERUPT  EINTR
+#define SOCKET_ERROR_TIMEDOUT  EAGAIN
+#define WRITE(a,b,c)           write(a,b,c)
+#define WRITEV(a,b,c)          Writev(b, c)
+#define GETSOCKOPT(a,b,c,d,e)  getsockopt(a,b,c,(char *)d, (int *)e)
+#define SETSOCKOPT(a,b,c,d,e)  setsockopt(a,b,c,(char *)d, (int)e)
+#define GETHOSTBYNAME(a)       gethostbyname(a)
+#endif
+
+#if defined(_LINUX) || defined(_DARWIN)
+#define ACCEPT(a,b,c)          accept(a,b,c)
+#define CONNECT(a,b,c)         connect(a,b,c)
+#define CLOSE(a)               close(a)
+#define READ(a,b,c)            read(a,b,c)
+#define RECV(a,b,c,d)          recv(a, (void *)b, c, d)
+#define RECVFROM(a,b,c,d,e,f)  recvfrom(a, (char *)b, c, d, (sockaddr *)e, f)
+#define RECV_FLAGS             MSG_WAITALL
+#define SELECT(a,b,c,d,e)      select(a,b,c,d,e)
+#define SEND(a,b,c,d)          send(a, (const int8 *)b, c, d)
+#define SENDTO(a,b,c,d,e,f)    sendto(a, (const int8 *)b, c, d, e, f)
+#define SEND_FLAGS             0
+#define SENDFILE(a,b,c,d)      sendfile(a, b, c, d)
+#define SET_SOCKET_ERROR(x,y)  errno=y
+#define SOCKET_ERROR_INTERUPT  EINTR
+#define SOCKET_ERROR_TIMEDOUT  EAGAIN
+#define WRITE(a,b,c)           write(a,b,c)
+#define WRITEV(a,b,c)          writev(a, b, c)
+#define GETSOCKOPT(a,b,c,d,e)  getsockopt((int)a,(int)b,(int)c,(void *)d,(socklen_t *)e)
+#define SETSOCKOPT(a,b,c,d,e)  setsockopt((int)a,(int)b,(int)c,(const void *)d,(int)e)
+#define GETHOSTBYNAME(a)       gethostbyname(a)
+#endif
+
+
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* File Macros                                                               */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+#define STRUCT_STAT         struct stat
+#define LSTAT(x,y)          lstat(x,y)
+#define FILE_HANDLE         FILE *
+#define CLEARERR(x)         clearerr(x)
+#define FCLOSE(x)           fclose(x)
+#define FEOF(x)             feof(x)
+#define FERROR(x)           ferror(x)
+#define FFLUSH(x)           fflush(x)
+#define FILENO(s)           fileno(s)
+#define FOPEN(x,y)          fopen(x, y)
+  //#define FREAD(a,b,c,d)      fread(a, b, c, d)
+#define FSTAT(s, st)        fstat(FILENO(s), st)
+    //#define FWRITE(a,b,c,d)     fwrite(a, b, c, d)
+#define STAT_BLK_SIZE(x)    ((x).st_blksize)
+
+
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* Misc Macros                                                               */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+#if defined(WIN32)
+  #define GET_CLOCK_COUNT(x) QueryPerformanceCounter((LARGE_INTEGER *)x)
+#else
+  #define GET_CLOCK_COUNT(x) gettimeofday(x, NULL)
+#endif
+
+#if defined(WIN32)
+  #define STRTOULL(x) _atoi64(x)
+#else
+  #define STRTOULL(x) strtoull(x, NULL, 10)
+#endif
+
+#if defined(WIN32)
+  #define SNPRINTF _snprintf
+  #define PRINTF   printf
+  #define VPRINTF  vprintf
+  #define FPRINTF  fprintf
+#else
+  #define SNPRINTF snprintf
+  #define PRINTF   printf
+  #define VPRINTF  vprintf
+  #define FPRINTF  fprintf
+#endif
+
+#ifdef _MSC_VER
+  #define EXPORT __declspec(dllexport)
+#else
+  #define EXPORT
+#endif
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __HOST_H__ */

+ 328 - 0
pico-tcp-service/pico-tcp-client/src/PassiveSocket.cpp

@@ -0,0 +1,328 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* PassiveSocket.cpp - Passive Socket Implementation                         */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#include "PassiveSocket.h"
+
+
+
+CPassiveSocket::CPassiveSocket(CSocketType nType) : CSimpleSocket(nType)
+{
+}
+
+bool CPassiveSocket::BindMulticast(const char *pInterface, const char *pGroup, uint16 nPort)
+{
+    bool           bRetVal = false;
+#ifdef WIN32
+    ULONG          inAddr;
+#else
+    in_addr_t      inAddr;
+#endif
+
+    //--------------------------------------------------------------------------
+    // Set the following socket option SO_REUSEADDR.  This will allow the file
+    // descriptor to be reused immediately after the socket is closed instead
+    // of setting in a TIMED_WAIT state.
+    //--------------------------------------------------------------------------
+    memset(&m_stMulticastGroup,0,sizeof(m_stMulticastGroup));
+    m_stMulticastGroup.sin_family = AF_INET;
+    m_stMulticastGroup.sin_port = htons(nPort);
+
+    //--------------------------------------------------------------------------
+    // If no IP Address (interface ethn) is supplied, or the loop back is
+    // specified then bind to any interface, else bind to specified interface.
+    //--------------------------------------------------------------------------
+    if ((pInterface == NULL) || (!strlen(pInterface)))
+    {
+        m_stMulticastGroup.sin_addr.s_addr = htonl(INADDR_ANY);
+    }
+    else
+    {
+        if ((inAddr = inet_addr(pInterface)) != INADDR_NONE)
+        {
+            m_stMulticastGroup.sin_addr.s_addr = inAddr;
+        }
+    }
+
+    //--------------------------------------------------------------------------
+    // Bind to the specified port
+    //--------------------------------------------------------------------------
+    if (bind(m_socket, (struct sockaddr *)&m_stMulticastGroup, sizeof(m_stMulticastGroup)) == 0)
+    {
+        //----------------------------------------------------------------------
+        // Join the multicast group
+        //----------------------------------------------------------------------
+        m_stMulticastRequest.imr_multiaddr.s_addr = inet_addr(pGroup);
+        m_stMulticastRequest.imr_interface.s_addr = m_stMulticastGroup.sin_addr.s_addr;
+
+        if (SETSOCKOPT(m_socket, IPPROTO_IP, IP_ADD_MEMBERSHIP,
+                       (void *)&m_stMulticastRequest,
+                       sizeof(m_stMulticastRequest)) == CSimpleSocket::SocketSuccess)
+        {
+            bRetVal = true;
+        }
+
+        m_timer.SetEndTime();
+    }
+
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+
+    //--------------------------------------------------------------------------
+    // If there was a socket error then close the socket to clean out the
+    // connection in the backlog.
+    //--------------------------------------------------------------------------
+    TranslateSocketError();
+
+    if (bRetVal == false)
+    {
+        Close();
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Listen() -
+//
+//------------------------------------------------------------------------------
+bool CPassiveSocket::Listen(const char *pAddr, uint16 nPort, int32 nConnectionBacklog)
+{
+    bool           bRetVal = false;
+#ifdef WIN32
+    ULONG          inAddr;
+#else
+    in_addr_t      inAddr;
+
+    int32          nReuse;
+    nReuse = IPTOS_LOWDELAY;
+
+    //--------------------------------------------------------------------------
+    // Set the following socket option SO_REUSEADDR.  This will allow the file
+    // descriptor to be reused immediately after the socket is closed instead
+    // of setting in a TIMED_WAIT state.
+    //--------------------------------------------------------------------------
+    SETSOCKOPT(m_socket, SOL_SOCKET, SO_REUSEADDR, (char*)&nReuse, sizeof(int32));
+    SETSOCKOPT(m_socket, IPPROTO_TCP, IP_TOS, &nReuse, sizeof(int32));
+#endif
+
+    memset(&m_stServerSockaddr,0,sizeof(m_stServerSockaddr));
+    m_stServerSockaddr.sin_family = AF_INET;
+    m_stServerSockaddr.sin_port = htons(nPort);
+
+    //--------------------------------------------------------------------------
+    // If no IP Address (interface ethn) is supplied, or the loop back is
+    // specified then bind to any interface, else bind to specified interface.
+    //--------------------------------------------------------------------------
+    if ((pAddr == NULL) || (!strlen(pAddr)))
+    {
+        m_stServerSockaddr.sin_addr.s_addr = htonl(INADDR_ANY);
+    }
+    else
+    {
+        if ((inAddr = inet_addr(pAddr)) != INADDR_NONE)
+        {
+            m_stServerSockaddr.sin_addr.s_addr = inAddr;
+        }
+    }
+
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+    //--------------------------------------------------------------------------
+    // Bind to the specified port
+    //--------------------------------------------------------------------------
+    if (bind(m_socket, (struct sockaddr *)&m_stServerSockaddr, sizeof(m_stServerSockaddr)) != CSimpleSocket::SocketError)
+    {
+        if (m_nSocketType == CSimpleSocket::SocketTypeTcp)
+        {
+            if (listen(m_socket, nConnectionBacklog) != CSimpleSocket::SocketError)
+            {
+                bRetVal = true;
+            }
+        }
+        else
+        {
+            bRetVal = true;
+        }
+    }
+
+    m_timer.SetEndTime();
+
+    //--------------------------------------------------------------------------
+    // If there was a socket error then close the socket to clean out the
+    // connection in the backlog.
+    //--------------------------------------------------------------------------
+    TranslateSocketError();
+
+    if (bRetVal == false)
+    {
+        CSocketError err = GetSocketError();
+        Close();
+        SetSocketError(err);
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Accept() -
+//
+//------------------------------------------------------------------------------
+CActiveSocket *CPassiveSocket::Accept()
+{
+    uint32         nSockLen;
+    CActiveSocket *pClientSocket = NULL;
+    SOCKET         socket = CSimpleSocket::SocketError;
+
+    if (m_nSocketType != CSimpleSocket::SocketTypeTcp)
+    {
+        SetSocketError(CSimpleSocket::SocketProtocolError);
+        return pClientSocket;
+    }
+
+    pClientSocket = new CActiveSocket();
+
+    //--------------------------------------------------------------------------
+    // Wait for incoming connection.
+    //--------------------------------------------------------------------------
+    if (pClientSocket != NULL)
+    {
+        CSocketError socketErrno = SocketSuccess;
+
+        m_timer.Initialize();
+        m_timer.SetStartTime();
+
+        nSockLen = sizeof(m_stClientSockaddr);
+
+        do
+        {
+            errno = 0;
+            socket = accept(m_socket, (struct sockaddr *)&m_stClientSockaddr, (socklen_t *)&nSockLen);
+
+            if (socket != -1)
+            {
+                pClientSocket->SetSocketHandle(socket);
+                pClientSocket->TranslateSocketError();
+                socketErrno = pClientSocket->GetSocketError();
+                socklen_t nSockLen = sizeof(struct sockaddr);
+
+                //-------------------------------------------------------------
+                // Store client and server IP and port information for this
+                // connection.
+                //-------------------------------------------------------------
+                getpeername(m_socket, (struct sockaddr *)&pClientSocket->m_stClientSockaddr, &nSockLen);
+                memcpy((void *)&pClientSocket->m_stClientSockaddr, (void *)&m_stClientSockaddr, nSockLen);
+
+                memset(&pClientSocket->m_stServerSockaddr, 0, nSockLen);
+                getsockname(m_socket, (struct sockaddr *)&pClientSocket->m_stServerSockaddr, &nSockLen);
+            }
+            else
+            {
+                TranslateSocketError();
+                socketErrno = GetSocketError();
+            }
+
+        } while (socketErrno == CSimpleSocket::SocketInterrupted);
+
+        m_timer.SetEndTime();
+
+        if (socketErrno != CSimpleSocket::SocketSuccess)
+        {
+            delete pClientSocket;
+            pClientSocket = NULL;
+        }
+    }
+
+    return pClientSocket;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Send() - Send data on a valid socket
+//
+//------------------------------------------------------------------------------
+int32 CPassiveSocket::Send(const uint8 *pBuf, size_t bytesToSend)
+{
+    SetSocketError(SocketSuccess);
+    m_nBytesSent = 0;
+
+    switch(m_nSocketType)
+    {
+    case CSimpleSocket::SocketTypeUdp:
+    {
+        if (IsSocketValid())
+        {
+            if ((bytesToSend > 0) && (pBuf != NULL))
+            {
+                m_timer.Initialize();
+                m_timer.SetStartTime();
+
+                m_nBytesSent = SENDTO(m_socket, pBuf, bytesToSend, 0,
+                                      (const sockaddr *)&m_stClientSockaddr,
+                                      sizeof(m_stClientSockaddr));
+
+                m_timer.SetEndTime();
+
+                if (m_nBytesSent == CSimpleSocket::SocketError)
+                {
+                    TranslateSocketError();
+                }
+            }
+        }
+        break;
+    }
+    case CSimpleSocket::SocketTypeTcp:
+        CSimpleSocket::Send(pBuf, bytesToSend);
+        break;
+    default:
+        SetSocketError(SocketProtocolError);
+        break;
+    }
+
+    return m_nBytesSent;
+}

+ 119 - 0
pico-tcp-service/pico-tcp-client/src/PassiveSocket.h

@@ -0,0 +1,119 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* Socket.h - Passive Socket Decleration.                                    */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#ifndef __PASSIVESOCKET_H__
+#define __PASSIVESOCKET_H__
+#include "ActiveSocket.h"
+
+/// Provides a platform independent class to create a passive socket.
+/// A passive socket is used to create a "listening" socket.  This type
+/// of object would be used when an application needs to wait for
+/// inbound connections.  Support for CSimpleSocket::SocketTypeTcp,
+/// CSimpleSocket::SocketTypeUdp, and CSimpleSocket::SocketTypeRaw is handled
+/// in a similar fashion.  The big difference is that the method
+/// CPassiveSocket::Accept should not be called on the latter two socket
+/// types.
+class EXPORT CPassiveSocket : public CSimpleSocket {
+public:
+    CPassiveSocket(CSocketType type = SocketTypeTcp);
+    virtual ~CPassiveSocket() {
+        Close();
+    };
+
+    /// Extracts the first connection request on the queue of pending
+    /// connections and creates a newly connected socket.  Used with
+    /// CSocketType CSimpleSocket::SocketTypeTcp.  It is the responsibility of
+    /// the caller to delete the returned object when finished.
+    ///  @return if successful a pointer to a newly created CActiveSocket object
+    ///          will be returned and the internal error condition of the CPassiveSocket
+    ///          object will be CPassiveSocket::SocketSuccess.  If an error condition was encountered
+    ///          the NULL will be returned and one of the following error conditions will be set:
+    ///    CPassiveSocket::SocketEwouldblock, CPassiveSocket::SocketInvalidSocket,
+    ///    CPassiveSocket::SocketConnectionAborted, CPassiveSocket::SocketInterrupted
+    ///    CPassiveSocket::SocketProtocolError, CPassiveSocket::SocketFirewallError
+    virtual CActiveSocket *Accept(void);
+
+    /// Bind to a multicast group on  a specified interface, multicast group, and port
+    ///
+    ///  @param pInterface - interface on which to bind.
+    ///  @param pGroup - multicast group address to bind.
+    ///  @param nPort - port on which multicast
+    ///  @return true if able to bind to interface and multicast group.
+    ///      If not successful, the false is returned and one of the following error
+    ///      condiitions will be set: CPassiveSocket::SocketAddressInUse, CPassiveSocket::SocketProtocolError,
+    ///      CPassiveSocket::SocketInvalidSocket.  The following socket errors are for Linux/Unix
+    ///      derived systems only: CPassiveSocket::SocketInvalidSocketBuffer
+    bool BindMulticast(const char *pInterface, const char *pGroup, uint16 nPort);
+
+    /// Create a listening socket at local ip address 'x.x.x.x' or 'localhost'
+    /// if pAddr is NULL on port nPort.
+    ///
+    ///  @param pAddr specifies the IP address on which to listen.
+    ///  @param nPort specifies the port on which to listen.
+    ///  @param nConnectionBacklog specifies connection queue backlog (default 30,000)
+    ///  @return true if a listening socket was created.
+    ///      If not successful, the false is returned and one of the following error
+    ///      conditions will be set: CPassiveSocket::SocketAddressInUse, CPassiveSocket::SocketProtocolError,
+    ///      CPassiveSocket::SocketInvalidSocket.  The following socket errors are for Linux/Unix
+    ///      derived systems only: CPassiveSocket::SocketInvalidSocketBuffer
+    virtual bool Listen(const char *pAddr, uint16 nPort, int32 nConnectionBacklog = 30000);
+
+    /// Attempts to send a block of data on an established connection.
+    /// @param pBuf block of data to be sent.
+    /// @param bytesToSend size of data block to be sent.
+    /// @return number of bytes actually sent, return of zero means the
+    /// connection has been shutdown on the other side, and a return of -1
+    /// means that an error has occurred.  If an error was signaled then one
+    /// of the following error codes will be set: CPassiveSocket::SocketInvalidSocket,
+    /// CPassiveSocket::SocketEwouldblock, SimpleSocket::SocketConnectionReset,
+    /// CPassiveSocket::SocketInvalidSocketBuffer, CPassiveSocket::SocketInterrupted,
+    /// CPassiveSocket::SocketProtocolError, CPassiveSocket::SocketNotconnected
+    /// <br>\b Note: This function is used only for a socket of type
+    /// CSimpleSocket::SocketTypeUdp
+    virtual int32 Send(const uint8 *pBuf, size_t bytesToSend);
+
+private:
+    struct ip_mreq  m_stMulticastRequest;   /// group address for multicast
+
+};
+
+#endif // __PASSIVESOCKET_H__

+ 1189 - 0
pico-tcp-service/pico-tcp-client/src/SimpleSocket.cpp

@@ -0,0 +1,1189 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* CSimpleSocket.cpp - CSimpleSocket Implementation                          */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#include "SimpleSocket.h"
+
+CSimpleSocket::CSimpleSocket(CSocketType nType) :
+    m_socket(INVALID_SOCKET),
+    m_socketErrno(CSimpleSocket::SocketInvalidSocket),
+    m_pBuffer(NULL), m_nBufferSize(0), m_nSocketDomain(AF_INET),
+    m_nSocketType(SocketTypeInvalid), m_nBytesReceived(-1),
+    m_nBytesSent(-1), m_nFlags(0),
+    m_bIsBlocking(true), m_bIsMulticast(false)
+{
+    SetConnectTimeout(1, 0);
+    memset(&m_stRecvTimeout, 0, sizeof(struct timeval));
+    memset(&m_stSendTimeout, 0, sizeof(struct timeval));
+    memset(&m_stLinger, 0, sizeof(struct linger));
+
+    switch(nType)
+    {
+        //----------------------------------------------------------------------
+        // Declare socket type stream - TCP
+        //----------------------------------------------------------------------
+    case CSimpleSocket::SocketTypeTcp:
+    {
+        m_nSocketDomain = AF_INET;
+        m_nSocketType = CSimpleSocket::SocketTypeTcp;
+        break;
+    }
+    case CSimpleSocket::SocketTypeTcp6:
+    {
+        m_nSocketDomain = AF_INET6;
+        m_nSocketType = CSimpleSocket::SocketTypeTcp6;
+        break;
+    }
+    //----------------------------------------------------------------------
+    // Declare socket type datagram - UDP
+    //----------------------------------------------------------------------
+    case CSimpleSocket::SocketTypeUdp:
+    {
+        m_nSocketDomain = AF_INET;
+        m_nSocketType = CSimpleSocket::SocketTypeUdp;
+        break;
+    }
+    case CSimpleSocket::SocketTypeUdp6:
+    {
+        m_nSocketDomain = AF_INET6;
+        m_nSocketType = CSimpleSocket::SocketTypeUdp6;
+        break;
+    }
+    //----------------------------------------------------------------------
+    // Declare socket type raw Ethernet - Ethernet
+    //----------------------------------------------------------------------
+    case CSimpleSocket::SocketTypeRaw:
+    {
+#if defined(_LINUX) && !defined(_DARWIN)
+        m_nSocketDomain = AF_PACKET;
+        m_nSocketType = CSimpleSocket::SocketTypeRaw;
+#endif
+#ifdef _WIN32
+        m_nSocketType = CSimpleSocket::SocketTypeInvalid;
+#endif
+        break;
+    }
+    default:
+        m_nSocketType = CSimpleSocket::SocketTypeInvalid;
+        break;
+    }
+}
+
+CSimpleSocket::CSimpleSocket(CSimpleSocket &socket)
+{
+    m_pBuffer = new uint8[socket.m_nBufferSize];
+    m_nBufferSize = socket.m_nBufferSize;
+    memcpy(m_pBuffer, socket.m_pBuffer, socket.m_nBufferSize);
+}
+
+CSimpleSocket *CSimpleSocket::operator=(CSimpleSocket &socket)
+{
+    if (m_nBufferSize != socket.m_nBufferSize)
+    {
+        delete m_pBuffer;
+        m_pBuffer = new uint8[socket.m_nBufferSize];
+        m_nBufferSize = socket.m_nBufferSize;
+        memcpy(m_pBuffer, socket.m_pBuffer, socket.m_nBufferSize);
+    }
+
+    return this;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Initialize() - Initialize socket class
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::Initialize()
+{
+    errno = CSimpleSocket::SocketSuccess;
+
+#ifdef WIN32
+    //-------------------------------------------------------------------------
+    // Data structure containing general Windows Sockets Info
+    //-------------------------------------------------------------------------
+    memset(&m_hWSAData, 0, sizeof(m_hWSAData));
+    WSAStartup(MAKEWORD(2, 0), &m_hWSAData);
+#endif
+
+    //-------------------------------------------------------------------------
+    // Create the basic Socket Handle
+    //-------------------------------------------------------------------------
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+    m_socket = socket(m_nSocketDomain, m_nSocketType, 0);
+    m_timer.SetEndTime();
+
+    TranslateSocketError();
+
+    return (IsSocketValid());
+}
+
+
+//------------------------------------------------------------------------------
+//
+// BindInterface()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::BindInterface(const char *pInterface)
+{
+    bool           bRetVal = false;
+    struct in_addr stInterfaceAddr;
+
+    if (GetMulticast() == true)
+    {
+        if (pInterface)
+        {
+            stInterfaceAddr.s_addr= inet_addr(pInterface);
+            if (SETSOCKOPT(m_socket, IPPROTO_IP, IP_MULTICAST_IF, &stInterfaceAddr, sizeof(stInterfaceAddr)) == SocketSuccess)
+            {
+                bRetVal = true;
+            }
+        }
+    }
+    else
+    {
+        SetSocketError(CSimpleSocket::SocketProtocolError);
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetMulticast()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetMulticast(bool bEnable, uint8 multicastTTL)
+{
+    bool bRetVal = false;
+
+    if (GetSocketType() == CSimpleSocket::SocketTypeUdp)
+    {
+        m_bIsMulticast = bEnable;
+        if (SETSOCKOPT(m_socket, IPPROTO_IP, IP_MULTICAST_TTL, (void *)&multicastTTL, sizeof(multicastTTL)) == SocketError)
+        {
+            TranslateSocketError();
+            bRetVal = false;
+        }
+        else
+        {
+            bRetVal = true;
+        }
+    }
+    else
+    {
+        m_socketErrno = CSimpleSocket::SocketProtocolError;
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetSocketDscp()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetSocketDscp(int32 nDscp)
+{
+    bool  bRetVal = true;
+    int32 nTempVal = nDscp;
+
+    nTempVal <<= 4;
+    nTempVal /= 4;
+
+    if (IsSocketValid())
+    {
+        if (SETSOCKOPT(m_socket, IPPROTO_IP, IP_TOS, &nTempVal, sizeof(nTempVal)) == SocketError)
+        {
+            TranslateSocketError();
+            bRetVal = false;
+        }
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// GetSocketDscp()
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::GetSocketDscp(void)
+{
+    int32      nTempVal = 0;
+    socklen_t  nLen = 0;
+
+    if (IsSocketValid())
+    {
+        if (GETSOCKOPT(m_socket, IPPROTO_IP, IP_TOS, &nTempVal, &nLen) == SocketError)
+        {
+            TranslateSocketError();
+        }
+
+        nTempVal *= 4;
+        nTempVal >>= 4;
+    }
+
+    return nTempVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// GetWindowSize()
+//
+//------------------------------------------------------------------------------
+uint32 CSimpleSocket::GetWindowSize(uint32 nOptionName)
+{
+    uint32 nTcpWinSize = 0;
+
+    //-------------------------------------------------------------------------
+    // no socket given, return system default allocate our own new socket
+    //-------------------------------------------------------------------------
+    if (m_socket != CSimpleSocket::SocketError)
+    {
+        socklen_t nLen = sizeof(nTcpWinSize);
+
+        //---------------------------------------------------------------------
+        // query for buffer size
+        //---------------------------------------------------------------------
+        GETSOCKOPT(m_socket, SOL_SOCKET, nOptionName, &nTcpWinSize, &nLen);
+        TranslateSocketError();
+    }
+    else
+    {
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+    }
+
+    return nTcpWinSize;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetWindowSize()
+//
+//------------------------------------------------------------------------------
+uint32 CSimpleSocket::SetWindowSize(uint32 nOptionName, uint32 nWindowSize)
+{
+    //-------------------------------------------------------------------------
+    // no socket given, return system default allocate our own new socket
+    //-------------------------------------------------------------------------
+    if (m_socket != CSimpleSocket::SocketError)
+    {
+        SETSOCKOPT(m_socket, SOL_SOCKET, nOptionName, &nWindowSize, sizeof(nWindowSize));
+        TranslateSocketError();
+    }
+    else
+    {
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+    }
+
+    return nWindowSize;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// DisableNagleAlgorithm()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::DisableNagleAlgoritm()
+{
+    bool  bRetVal = false;
+    int32 nTcpNoDelay = 1;
+
+    //----------------------------------------------------------------------
+    // Set TCP NoDelay flag to true
+    //----------------------------------------------------------------------
+    if (SETSOCKOPT(m_socket, IPPROTO_TCP, TCP_NODELAY, &nTcpNoDelay, sizeof(int32)) == 0)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// EnableNagleAlgorithm()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::EnableNagleAlgoritm()
+{
+    bool  bRetVal = false;
+    int32 nTcpNoDelay = 0;
+
+    //----------------------------------------------------------------------
+    // Set TCP NoDelay flag to false
+    //----------------------------------------------------------------------
+    if (SETSOCKOPT(m_socket, IPPROTO_TCP, TCP_NODELAY, &nTcpNoDelay, sizeof(int32)) == 0)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Send() - Send data on a valid socket
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::Send(const uint8 *pBuf, size_t bytesToSend)
+{
+    SetSocketError(SocketSuccess);
+    m_nBytesSent = 0;
+
+    switch(m_nSocketType)
+    {
+    case CSimpleSocket::SocketTypeTcp:
+    {
+        if (IsSocketValid())
+        {
+            if ((bytesToSend > 0) && (pBuf != NULL))
+            {
+                m_timer.Initialize();
+                m_timer.SetStartTime();
+
+                //---------------------------------------------------------
+                // Check error condition and attempt to resend if call
+                // was interrupted by a signal.
+                //---------------------------------------------------------
+                do
+                {
+                    m_nBytesSent = SEND(m_socket, pBuf, bytesToSend, 0);
+                    TranslateSocketError();
+                } while (GetSocketError() == CSimpleSocket::SocketInterrupted);
+
+                m_timer.SetEndTime();
+            }
+        }
+        break;
+    }
+    case CSimpleSocket::SocketTypeUdp:
+    {
+        if (IsSocketValid())
+        {
+            if ((bytesToSend > 0) && (pBuf != NULL))
+            {
+                m_timer.Initialize();
+                m_timer.SetStartTime();
+
+                //---------------------------------------------------------
+                // Check error condition and attempt to resend if call
+                // was interrupted by a signal.
+                //---------------------------------------------------------
+                //                    if (GetMulticast())
+                //                    {
+                //                        do
+                //                        {
+                //                            m_nBytesSent = SENDTO(m_socket, pBuf, bytesToSend, 0, (const sockaddr *)&m_stMulticastGroup,
+                //                                                  sizeof(m_stMulticastGroup));
+                //                            TranslateSocketError();
+                //                        } while (GetSocketError() == CSimpleSocket::SocketInterrupted);
+                //                    }
+                //                    else
+                {
+                    do
+                    {
+                        m_nBytesSent = SENDTO(m_socket, pBuf, bytesToSend, 0, (const sockaddr *)&m_stServerSockaddr, sizeof(m_stServerSockaddr));
+                        TranslateSocketError();
+                    } while (GetSocketError() == CSimpleSocket::SocketInterrupted);
+                }
+
+                m_timer.SetEndTime();
+            }
+        }
+        break;
+    }
+    default:
+        break;
+    }
+
+    return m_nBytesSent;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Close() - Close socket and free up any memory allocated for the socket
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::Close(void)
+{
+    bool bRetVal = false;
+
+    //--------------------------------------------------------------------------
+    // delete internal buffer
+    //--------------------------------------------------------------------------
+    if (m_pBuffer != NULL)
+    {
+        delete [] m_pBuffer;
+        m_pBuffer = NULL;
+    }
+
+    //--------------------------------------------------------------------------
+    // if socket handle is currently valid, close and then invalidate
+    //--------------------------------------------------------------------------
+    if (IsSocketValid())
+    {
+        if (CLOSE(m_socket) != CSimpleSocket::SocketError)
+        {
+            m_socket = INVALID_SOCKET;
+            bRetVal = true;
+        }
+    }
+
+    TranslateSocketError();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Shtudown()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::Shutdown(CShutdownMode nShutdown)
+{
+    CSocketError nRetVal = SocketEunknown;
+
+    nRetVal = (CSocketError)shutdown(m_socket, nShutdown);
+    TranslateSocketError();
+
+    return (nRetVal == CSimpleSocket::SocketSuccess) ? true: false;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Flush()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::Flush()
+{
+    int32 nTcpNoDelay = 1;
+    int32 nCurFlags = 0;
+    uint8 tmpbuf = 0;
+    bool  bRetVal = false;
+
+    //--------------------------------------------------------------------------
+    // Get the current setting of the TCP_NODELAY flag.
+    //--------------------------------------------------------------------------
+    if (GETSOCKOPT(m_socket, IPPROTO_TCP, TCP_NODELAY, &nCurFlags, sizeof(int32)) == 0)
+    {
+        //----------------------------------------------------------------------
+        // Set TCP NoDelay flag
+        //----------------------------------------------------------------------
+        if (SETSOCKOPT(m_socket, IPPROTO_TCP, TCP_NODELAY, &nTcpNoDelay, sizeof(int32)) == 0)
+        {
+            //------------------------------------------------------------------
+            // Send empty byte stream to flush the TCP send buffer
+            //------------------------------------------------------------------
+            if (Send(&tmpbuf, 0) != CSimpleSocket::SocketError)
+            {
+                bRetVal = true;
+            }
+
+            TranslateSocketError();
+        }
+
+        //----------------------------------------------------------------------
+        // Reset the TCP_NODELAY flag to original state.
+        //----------------------------------------------------------------------
+        SETSOCKOPT(m_socket, IPPROTO_TCP, TCP_NODELAY, &nCurFlags, sizeof(int32));
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Writev -
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::Writev(const struct iovec *pVector, size_t nCount)
+{
+    int32 nBytes     = 0;
+    int32 nBytesSent = 0;
+    int32 i          = 0;
+
+    //--------------------------------------------------------------------------
+    // Send each buffer as a separate send, windows does not support this
+    // function call.
+    //--------------------------------------------------------------------------
+    for (i = 0; i < (int32)nCount; i++)
+    {
+        if ((nBytes = Send((uint8 *)pVector[i].iov_base, pVector[i].iov_len)) == CSimpleSocket::SocketError)
+        {
+            break;
+        }
+
+        nBytesSent += nBytes;
+    }
+
+    if (i > 0)
+    {
+        Flush();
+    }
+
+    return nBytesSent;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Send() - Send data on a valid socket via a vector of buffers.
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::Send(const struct iovec *sendVector, int32 nNumItems)
+{
+    SetSocketError(SocketSuccess);
+    m_nBytesSent = 0;
+
+    if ((m_nBytesSent = WRITEV(m_socket, sendVector, nNumItems)) == CSimpleSocket::SocketError)
+    {
+        TranslateSocketError();
+    }
+
+    return m_nBytesSent;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetReceiveTimeout()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetReceiveTimeout(int32 nRecvTimeoutSec, int32 nRecvTimeoutUsec)
+{
+    bool bRetVal = true;
+
+    memset(&m_stRecvTimeout, 0, sizeof(struct timeval));
+
+    m_stRecvTimeout.tv_sec = nRecvTimeoutSec;
+    m_stRecvTimeout.tv_usec = nRecvTimeoutUsec;
+
+    //--------------------------------------------------------------------------
+    // Sanity check to make sure the options are supported!
+    //--------------------------------------------------------------------------
+    if (SETSOCKOPT(m_socket, SOL_SOCKET, SO_RCVTIMEO, &m_stRecvTimeout,
+                   sizeof(struct timeval)) == CSimpleSocket::SocketError)
+    {
+        bRetVal = false;
+        TranslateSocketError();
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetSendTimeout()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetSendTimeout(int32 nSendTimeoutSec, int32 nSendTimeoutUsec)
+{
+    bool bRetVal = true;
+
+    memset(&m_stSendTimeout, 0, sizeof(struct timeval));
+    m_stSendTimeout.tv_sec = nSendTimeoutSec;
+    m_stSendTimeout.tv_usec = nSendTimeoutUsec;
+
+    //--------------------------------------------------------------------------
+    // Sanity check to make sure the options are supported!
+    //--------------------------------------------------------------------------
+    if (SETSOCKOPT(m_socket, SOL_SOCKET, SO_SNDTIMEO, &m_stSendTimeout,
+                   sizeof(struct timeval)) == CSimpleSocket::SocketError)
+    {
+        bRetVal = false;
+        TranslateSocketError();
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetOptionReuseAddr()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetOptionReuseAddr()
+{
+    bool  bRetVal = false;
+    int32 nReuse  = IPTOS_LOWDELAY;
+
+    if (SETSOCKOPT(m_socket, SOL_SOCKET, SO_REUSEADDR, (char*)&nReuse, sizeof(int32)) == 0)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetOptionLinger()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetOptionLinger(bool bEnable, uint16 nTime)
+{
+    bool bRetVal = false;
+
+    m_stLinger.l_onoff = (bEnable == true) ? 1: 0;
+    m_stLinger.l_linger = nTime;
+
+    if (SETSOCKOPT(m_socket, SOL_SOCKET, SO_LINGER, &m_stLinger, sizeof(m_stLinger)) == 0)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Receive() - Attempts to receive a block of data on an established
+//             connection.    Data is received in an internal buffer managed
+//             by the class.  This buffer is only valid until the next call
+//             to Receive(), a call to Close(), or until the object goes out
+//             of scope.
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::Receive(int32 nMaxBytes, uint8 * pBuffer )
+{
+    m_nBytesReceived = 0;
+
+    //--------------------------------------------------------------------------
+    // If the socket is invalid then return false.
+    //--------------------------------------------------------------------------
+    if (IsSocketValid() == false)
+    {
+        return m_nBytesReceived;
+    }
+
+    uint8 * pWorkBuffer = pBuffer;
+    if ( pBuffer == NULL )
+    {
+        //--------------------------------------------------------------------------
+        // Free existing buffer and allocate a new buffer the size of
+        // nMaxBytes.
+        //--------------------------------------------------------------------------
+        if ((m_pBuffer != NULL) && (nMaxBytes != m_nBufferSize))
+        {
+            delete [] m_pBuffer;
+            m_pBuffer = NULL;
+        }
+
+        //--------------------------------------------------------------------------
+        // Allocate a new internal buffer to receive data.
+        //--------------------------------------------------------------------------
+        if (m_pBuffer == NULL)
+        {
+            m_nBufferSize = nMaxBytes;
+            m_pBuffer = new uint8[nMaxBytes];
+        }
+
+        pWorkBuffer = m_pBuffer;
+    }
+
+    SetSocketError(SocketSuccess);
+
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+    switch (m_nSocketType)
+    {
+        //----------------------------------------------------------------------
+        // If zero bytes are received, then return.  If SocketERROR is
+        // received, free buffer and return CSocket::SocketError (-1) to caller.
+        //----------------------------------------------------------------------
+    case CSimpleSocket::SocketTypeTcp:
+    {
+        do
+        {
+            m_nBytesReceived = RECV(m_socket, (pWorkBuffer + m_nBytesReceived),
+                                    nMaxBytes, m_nFlags);
+            TranslateSocketError();
+        } while ((GetSocketError() == CSimpleSocket::SocketInterrupted));
+
+        break;
+    }
+    case CSimpleSocket::SocketTypeUdp:
+    {
+        uint32 srcSize;
+
+        srcSize = sizeof(struct sockaddr_in);
+
+        if (GetMulticast() == true)
+        {
+            do
+            {
+                m_nBytesReceived = RECVFROM(m_socket, pWorkBuffer, nMaxBytes, 0,
+                                            &m_stMulticastGroup, &srcSize);
+                TranslateSocketError();
+            } while (GetSocketError() == CSimpleSocket::SocketInterrupted);
+        }
+        else
+        {
+            do
+            {
+                m_nBytesReceived = RECVFROM(m_socket, pWorkBuffer, nMaxBytes, 0,
+                                            &m_stClientSockaddr, &srcSize);
+                TranslateSocketError();
+            } while (GetSocketError() == CSimpleSocket::SocketInterrupted);
+        }
+
+        break;
+    }
+    default:
+        break;
+    }
+
+    m_timer.SetEndTime();
+    TranslateSocketError();
+
+    //--------------------------------------------------------------------------
+    // If we encounter an error translate the error code and return.  One
+    // possible error code could be EAGAIN (EWOULDBLOCK) if the socket is
+    // non-blocking.  This does not mean there is an error, but no data is
+    // yet available on the socket.
+    //--------------------------------------------------------------------------
+    if (m_nBytesReceived == CSimpleSocket::SocketError)
+    {
+        if (m_pBuffer != NULL)
+        {
+            delete [] m_pBuffer;
+            m_pBuffer = NULL;
+        }
+    }
+
+    return m_nBytesReceived;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetNonblocking()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetNonblocking(void)
+{
+    int32  nCurFlags;
+
+#if WIN32
+    nCurFlags = 1;
+
+    if (ioctlsocket(m_socket, FIONBIO, (ULONG *)&nCurFlags) != 0)
+    {
+        TranslateSocketError();
+        return false;
+    }
+#else
+    if ((nCurFlags = fcntl(m_socket, F_GETFL)) < 0)
+    {
+        TranslateSocketError();
+        return false;
+    }
+
+    nCurFlags |= O_NONBLOCK;
+
+    if (fcntl(m_socket, F_SETFL, nCurFlags) != 0)
+    {
+        TranslateSocketError();
+        return false;
+    }
+#endif
+
+    m_bIsBlocking = false;
+
+    return true;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetBlocking()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetBlocking(void)
+{
+    int32 nCurFlags;
+
+#if WIN32
+    nCurFlags = 0;
+
+    if (ioctlsocket(m_socket, FIONBIO, (ULONG *)&nCurFlags) != 0)
+    {
+        return false;
+    }
+#else
+    if ((nCurFlags = fcntl(m_socket, F_GETFL)) < 0)
+    {
+        TranslateSocketError();
+        return false;
+    }
+
+    nCurFlags &= (~O_NONBLOCK);
+
+    if (fcntl(m_socket, F_SETFL, nCurFlags) != 0)
+    {
+        TranslateSocketError();
+        return false;
+    }
+#endif
+    m_bIsBlocking = true;
+
+    return true;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SendFile() - stands-in for system provided sendfile
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::SendFile(int32 nOutFd, int32 nInFd, off_t *pOffset, int32 nCount)
+{
+    int32  nOutCount = CSimpleSocket::SocketError;
+
+    static char szData[SOCKET_SENDFILE_BLOCKSIZE];
+    int32       nInCount = 0;
+
+    if (lseek(nInFd, *pOffset, SEEK_SET) == -1)
+    {
+        return -1;
+    }
+
+    while (nOutCount < nCount)
+    {
+        nInCount = (nCount - nOutCount) < SOCKET_SENDFILE_BLOCKSIZE ? (nCount - nOutCount) : SOCKET_SENDFILE_BLOCKSIZE;
+
+        if ((read(nInFd, szData, nInCount)) != (int32)nInCount)
+        {
+            return -1;
+        }
+
+        if ((SEND(nOutFd, szData, nInCount, 0)) != (int32)nInCount)
+        {
+            return -1;
+        }
+
+        nOutCount += nInCount;
+    }
+
+    *pOffset += nOutCount;
+
+    TranslateSocketError();
+
+    return nOutCount;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// TranslateSocketError() -
+//
+//------------------------------------------------------------------------------
+void CSimpleSocket::TranslateSocketError(void)
+{
+#if defined(_LINUX) || defined(_DARWIN)
+    switch (errno)
+    {
+    case EXIT_SUCCESS:
+        SetSocketError(CSimpleSocket::SocketSuccess);
+        break;
+    case ENOTCONN:
+        SetSocketError(CSimpleSocket::SocketNotconnected);
+        break;
+    case ENOTSOCK:
+    case EBADF:
+    case EACCES:
+    case EAFNOSUPPORT:
+    case EMFILE:
+    case ENFILE:
+    case ENOBUFS:
+    case ENOMEM:
+    case EPROTONOSUPPORT:
+    case EPIPE:
+    case EOPNOTSUPP:
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+        break;
+    case ECONNREFUSED :
+        SetSocketError(CSimpleSocket::SocketConnectionRefused);
+        break;
+    case ETIMEDOUT:
+        SetSocketError(CSimpleSocket::SocketTimedout);
+        break;
+    case EINPROGRESS:
+        SetSocketError(CSimpleSocket::SocketEinprogress);
+        break;
+    case EWOULDBLOCK:
+        //        case EAGAIN:
+        SetSocketError(CSimpleSocket::SocketEwouldblock);
+        break;
+    case EINTR:
+        SetSocketError(CSimpleSocket::SocketInterrupted);
+        break;
+    case ECONNABORTED:
+        SetSocketError(CSimpleSocket::SocketConnectionAborted);
+        break;
+    case EINVAL:
+    case EPROTO:
+        SetSocketError(CSimpleSocket::SocketProtocolError);
+        break;
+    case EPERM:
+        SetSocketError(CSimpleSocket::SocketFirewallError);
+        break;
+    case EFAULT:
+        SetSocketError(CSimpleSocket::SocketInvalidSocketBuffer);
+        break;
+    case ECONNRESET:
+    case ENOPROTOOPT:
+        SetSocketError(CSimpleSocket::SocketConnectionReset);
+        break;
+    case EADDRINUSE:
+        SetSocketError(CSimpleSocket::SocketAddressInUse);
+        break;
+    default:
+        SetSocketError(CSimpleSocket::SocketEunknown);
+        break;
+    }
+#endif
+#ifdef WIN32
+    int32 nError = WSAGetLastError();
+    switch (nError)
+    {
+    case EXIT_SUCCESS:
+        SetSocketError(CSimpleSocket::SocketSuccess);
+        break;
+    case WSAEBADF:
+    case WSAENOTCONN:
+        SetSocketError(CSimpleSocket::SocketNotconnected);
+        break;
+    case WSAEINTR:
+        SetSocketError(CSimpleSocket::SocketInterrupted);
+        break;
+    case WSAEACCES:
+    case WSAEAFNOSUPPORT:
+    case WSAEINVAL:
+    case WSAEMFILE:
+    case WSAENOBUFS:
+    case WSAEPROTONOSUPPORT:
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+        break;
+    case WSAECONNREFUSED :
+        SetSocketError(CSimpleSocket::SocketConnectionRefused);
+        break;
+    case WSAETIMEDOUT:
+        SetSocketError(CSimpleSocket::SocketTimedout);
+        break;
+    case WSAEINPROGRESS:
+        SetSocketError(CSimpleSocket::SocketEinprogress);
+        break;
+    case WSAECONNABORTED:
+        SetSocketError(CSimpleSocket::SocketConnectionAborted);
+        break;
+    case WSAEWOULDBLOCK:
+        SetSocketError(CSimpleSocket::SocketEwouldblock);
+        break;
+    case WSAENOTSOCK:
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+        break;
+    case WSAECONNRESET:
+        SetSocketError(CSimpleSocket::SocketConnectionReset);
+        break;
+    case WSANO_DATA:
+        SetSocketError(CSimpleSocket::SocketInvalidAddress);
+        break;
+    case WSAEADDRINUSE:
+        SetSocketError(CSimpleSocket::SocketAddressInUse);
+        break;
+    case WSAEFAULT:
+        SetSocketError(CSimpleSocket::SocketInvalidPointer);
+        break;
+    default:
+        SetSocketError(CSimpleSocket::SocketEunknown);
+        break;
+    }
+#endif
+}
+
+//------------------------------------------------------------------------------
+//
+// DescribeError()
+//
+//------------------------------------------------------------------------------
+
+const char *CSimpleSocket::DescribeError(CSocketError err)
+{
+    switch (err) {
+        case CSimpleSocket::SocketError:
+            return "Generic socket error translates to error below.";
+        case CSimpleSocket::SocketSuccess:
+            return "No socket error.";
+        case CSimpleSocket::SocketInvalidSocket:
+            return "Invalid socket handle.";
+        case CSimpleSocket::SocketInvalidAddress:
+            return "Invalid destination address specified.";
+        case CSimpleSocket::SocketInvalidPort:
+            return "Invalid destination port specified.";
+        case CSimpleSocket::SocketConnectionRefused:
+            return "No server is listening at remote address.";
+        case CSimpleSocket::SocketTimedout:
+            return "Timed out while attempting operation.";
+        case CSimpleSocket::SocketEwouldblock:
+            return "Operation would block if socket were blocking.";
+        case CSimpleSocket::SocketNotconnected:
+            return "Currently not connected.";
+        case CSimpleSocket::SocketEinprogress:
+            return "Socket is non-blocking and the connection cannot be completed immediately";
+        case CSimpleSocket::SocketInterrupted:
+            return "Call was interrupted by a signal that was caught before a valid connection arrived.";
+        case CSimpleSocket::SocketConnectionAborted:
+            return "The connection has been aborted.";
+        case CSimpleSocket::SocketProtocolError:
+            return "Invalid protocol for operation.";
+        case CSimpleSocket::SocketFirewallError:
+            return "Firewall rules forbid connection.";
+        case CSimpleSocket::SocketInvalidSocketBuffer:
+            return "The receive buffer point outside the process's address space.";
+        case CSimpleSocket::SocketConnectionReset:
+            return "Connection was forcibly closed by the remote host.";
+        case CSimpleSocket::SocketAddressInUse:
+            return "Address already in use.";
+        case CSimpleSocket::SocketInvalidPointer:
+            return "Pointer type supplied as argument is invalid.";
+        case CSimpleSocket::SocketEunknown:
+            return "Unknown error";
+        default:
+            return "No such CSimpleSocket error";
+    }
+}
+
+//------------------------------------------------------------------------------
+//
+// Select()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::Select(int32 nTimeoutSec, int32 nTimeoutUSec)
+{
+    bool            bRetVal = false;
+    struct timeval *pTimeout = NULL;
+    struct timeval  timeout;
+    int32           nNumDescriptors = -1;
+    int32           nError = 0;
+
+    FD_ZERO(&m_errorFds);
+    FD_ZERO(&m_readFds);
+    FD_ZERO(&m_writeFds);
+    FD_SET(m_socket, &m_errorFds);
+    FD_SET(m_socket, &m_readFds);
+    FD_SET(m_socket, &m_writeFds);
+
+    //---------------------------------------------------------------------
+    // If timeout has been specified then set value, otherwise set timeout
+    // to NULL which will block until a descriptor is ready for read/write
+    // or an error has occurred.
+    //---------------------------------------------------------------------
+    if ((nTimeoutSec > 0) || (nTimeoutUSec > 0))
+    {
+        timeout.tv_sec = nTimeoutSec;
+        timeout.tv_usec = nTimeoutUSec;
+        pTimeout = &timeout;
+    }
+
+    nNumDescriptors = SELECT(m_socket+1, &m_readFds, &m_writeFds, &m_errorFds, pTimeout);
+//    nNumDescriptors = SELECT(m_socket+1, &m_readFds, NULL, NULL, pTimeout);
+
+    //----------------------------------------------------------------------
+    // Handle timeout
+    //----------------------------------------------------------------------
+    if (nNumDescriptors == 0)
+    {
+        SetSocketError(CSimpleSocket::SocketTimedout);
+    }
+    //----------------------------------------------------------------------
+    // If a file descriptor (read/write) is set then check the
+    // socket error (SO_ERROR) to see if there is a pending error.
+    //----------------------------------------------------------------------
+    else if ((FD_ISSET(m_socket, &m_readFds)) || (FD_ISSET(m_socket, &m_writeFds)))
+    {
+        int32 nLen = sizeof(nError);
+
+        if (GETSOCKOPT(m_socket, SOL_SOCKET, SO_ERROR, &nError, &nLen) == 0)
+        {
+            errno = nError;
+
+            if (nError == 0)
+            {
+                bRetVal = true;
+            }
+        }
+
+        TranslateSocketError();
+    }
+
+    return bRetVal;
+}
+

+ 584 - 0
pico-tcp-service/pico-tcp-client/src/SimpleSocket.h

@@ -0,0 +1,584 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* SimpleSocket.h - Simple Socket base class decleration.                    */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#ifndef __SOCKET_H__
+#define __SOCKET_H__
+
+#include <sys/stat.h>
+#include <stdlib.h>
+#include <stdio.h>
+#include <stdarg.h>
+#include <errno.h>
+
+#if defined(_LINUX) || defined (_DARWIN)
+#include <sys/socket.h>
+#include <netinet/in.h>
+#include <arpa/inet.h>
+#include <netinet/tcp.h>
+#include <netinet/ip.h>
+#include <netdb.h>
+#endif
+#ifdef _LINUX
+#include <linux/if_packet.h>
+#include <linux/if_ether.h>
+#include <linux/if.h>
+#include <sys/sendfile.h>
+#endif
+#ifdef _DARWIN
+#include <net/if.h>
+#endif
+#if defined(_LINUX) || defined (_DARWIN)
+#include <sys/time.h>
+#include <sys/uio.h>
+#include <unistd.h>
+#include <fcntl.h>
+#endif
+
+#ifdef _WIN32
+#include <io.h>
+#include <winsock2.h>
+#include <ws2tcpip.h>
+#endif // _WIN32
+
+
+#define IPTOS_LOWDELAY  0x10
+
+#include "Host.h"
+#include "StatTimer.h"
+
+//-----------------------------------------------------------------------------
+// General class macro definitions and typedefs
+//-----------------------------------------------------------------------------
+#ifndef INVALID_SOCKET
+#define INVALID_SOCKET    ~(0)
+#endif
+
+#define SOCKET_SENDFILE_BLOCKSIZE 8192
+
+/// Provides a platform independent class to for socket development.
+/// This class is designed to abstract socket communication development in a
+/// platform independent manner.
+/// - Socket types
+///  -# CActiveSocket Class
+///  -# CPassiveSocket Class
+class EXPORT CSimpleSocket {
+public:
+    /// Defines the three possible states for shuting down a socket.
+    typedef enum
+    {
+        Receives = SHUT_RD, ///< Shutdown passive socket.
+        Sends = SHUT_WR,    ///< Shutdown active socket.
+        Both = SHUT_RDWR    ///< Shutdown both active and passive sockets.
+    } CShutdownMode;
+
+    /// Defines the socket types defined by CSimpleSocket class.
+    typedef enum
+    {
+        SocketTypeInvalid,   ///< Invalid socket type.
+        SocketTypeTcp,       ///< Defines socket as TCP socket.
+        SocketTypeUdp,       ///< Defines socket as UDP socket.
+        SocketTypeTcp6,      ///< Defines socket as IPv6 TCP socket.
+        SocketTypeUdp6,      ///< Defines socket as IPv6 UDP socket.
+        SocketTypeRaw        ///< Provides raw network protocol access.
+    } CSocketType;
+
+    /// Defines all error codes handled by the CSimpleSocket class.
+    typedef enum
+    {
+        SocketError = -1,          ///< Generic socket error translates to error below.
+        SocketSuccess = 0,         ///< No socket error.
+        SocketInvalidSocket,       ///< Invalid socket handle.
+        SocketInvalidAddress,      ///< Invalid destination address specified.
+        SocketInvalidPort,         ///< Invalid destination port specified.
+        SocketConnectionRefused,   ///< No server is listening at remote address.
+        SocketTimedout,            ///< Timed out while attempting operation.
+        SocketEwouldblock,         ///< Operation would block if socket were blocking.
+        SocketNotconnected,        ///< Currently not connected.
+        SocketEinprogress,         ///< Socket is non-blocking and the connection cannot be completed immediately
+        SocketInterrupted,         ///< Call was interrupted by a signal that was caught before a valid connection arrived.
+        SocketConnectionAborted,   ///< The connection has been aborted.
+        SocketProtocolError,       ///< Invalid protocol for operation.
+        SocketFirewallError,       ///< Firewall rules forbid connection.
+        SocketInvalidSocketBuffer, ///< The receive buffer point outside the process's address space.
+        SocketConnectionReset,     ///< Connection was forcibly closed by the remote host.
+        SocketAddressInUse,        ///< Address already in use.
+        SocketInvalidPointer,      ///< Pointer type supplied as argument is invalid.
+        SocketEunknown             ///< Unknown error please report to mark@carrierlabs.com
+    } CSocketError;
+
+public:
+    CSimpleSocket(CSocketType type = SocketTypeTcp);
+    CSimpleSocket(CSimpleSocket &socket);
+
+    virtual ~CSimpleSocket()
+    {
+        if (m_pBuffer != NULL)
+        {
+            delete [] m_pBuffer;
+            m_pBuffer = NULL;
+        }
+    };
+
+    /// Initialize instance of CSocket.  This method MUST be called before an
+    /// object can be used. Errors : CSocket::SocketProtocolError,
+    /// CSocket::SocketInvalidSocket,
+    /// @return true if properly initialized.
+    virtual bool Initialize(void);
+
+    /// Close socket
+    /// @return true if successfully closed otherwise returns false.
+    virtual bool Close(void);
+
+    /// Shutdown shut down socket send and receive operations
+    ///    CShutdownMode::Receives - Disables further receive operations.
+    ///    CShutdownMode::Sends    - Disables further send operations.
+    ///    CShutdownBoth::         - Disables further send and receive operations.
+    /// @param nShutdown specifies the type of shutdown.
+    /// @return true if successfully shutdown otherwise returns false.
+    virtual bool Shutdown(CShutdownMode nShutdown);
+
+    /// Examine the socket descriptor sets currently owned by the instance of
+    /// the socket class (the readfds, writefds, and errorfds parameters) to
+    /// see whether some of their descriptors are ready for reading, are ready
+    /// for writing, or have an exceptional condition pending, respectively.
+    /// Block until an event happens on the specified file descriptors.
+    /// @return true if socket has data ready, or false if not ready or timed out.
+    virtual bool Select(void) {
+        return Select(0,0);
+    };
+
+    /// Examine the socket descriptor sets currently owned by the instance of
+    /// the socket class (the readfds, writefds, and errorfds parameters) to
+    /// see whether some of their descriptors are ready for reading, are ready
+    /// for writing, or have an exceptional condition pending, respectively.
+    /// @param nTimeoutSec timeout in seconds for select.
+    /// @param nTimeoutUSec timeout in micro seconds for select.
+    /// @return true if socket has data ready, or false if not ready or timed out.
+    virtual bool Select(int32 nTimeoutSec, int32 nTimeoutUSec);
+
+    /// Does the current instance of the socket object contain a valid socket
+    /// descriptor.
+    ///  @return true if the socket object contains a valid socket descriptor.
+    virtual bool IsSocketValid(void) {
+        return (m_socket != SocketError);
+    };
+
+    /// Provides a standard error code for cross platform development by
+    /// mapping the operating system error to an error defined by the CSocket
+    /// class.
+    void TranslateSocketError(void);
+
+    /// Returns a human-readable description of the given error code
+    /// or the last error code of a socket
+    static const char *DescribeError(CSocketError err);
+    inline const char *DescribeError() {
+        return DescribeError(m_socketErrno);
+    };
+
+    /// Attempts to receive a block of data on an established connection.
+    /// @param nMaxBytes maximum number of bytes to receive.
+    /// @param pBuffer, memory where to receive the data,
+    ///        NULL receives to internal buffer returned with GetData()
+    ///        Non-NULL receives directly there, but GetData() will return WRONG ptr!
+    /// @return number of bytes actually received.
+    /// @return of zero means the connection has been shutdown on the other side.
+    /// @return of -1 means that an error has occurred.
+    virtual int32 Receive(int32 nMaxBytes = 1, uint8 * pBuffer = 0);
+
+    /// Attempts to send a block of data on an established connection.
+    /// @param pBuf block of data to be sent.
+    /// @param bytesToSend size of data block to be sent.
+    /// @return number of bytes actually sent.
+    /// @return of zero means the connection has been shutdown on the other side.
+    /// @return of -1 means that an error has occurred.
+    virtual int32 Send(const uint8 *pBuf, size_t bytesToSend);
+
+    /// Attempts to send at most nNumItem blocks described by sendVector
+    /// to the socket descriptor associated with the socket object.
+    /// @param sendVector pointer to an array of iovec structures
+    /// @param nNumItems number of items in the vector to process
+    /// <br>\b NOTE: Buffers are processed in the order specified.
+    /// @return number of bytes actually sent, return of zero means the
+    /// connection has been shutdown on the other side, and a return of -1
+    /// means that an error has occurred.
+    virtual int32 Send(const struct iovec *sendVector, int32 nNumItems);
+
+    /// Copies data between one file descriptor and another.
+    /// On some systems this copying is done within the kernel, and thus is
+    /// more efficient than the combination of CSimpleSocket::Send and
+    /// CSimpleSocket::Receive, which would require transferring data to and
+    /// from user space.
+    /// <br>\b Note: This is available on all implementations, but the kernel
+    /// implementation is only available on Unix type systems.
+    /// @param nOutFd descriptor opened for writing.
+    /// @param nInFd descriptor opened for reading.
+    /// @param pOffset from which to start reading data from input file.
+    /// @param nCount number of bytes to copy between file descriptors.
+    /// @return number of bytes written to the out socket descriptor.
+    virtual int32 SendFile(int32 nOutFd, int32 nInFd, off_t *pOffset, int32 nCount);
+
+    /// Returns blocking/non-blocking state of socket.
+    /// @return true if the socket is non-blocking, else return false.
+    bool IsNonblocking(void) {
+        return (m_bIsBlocking == false);
+    };
+
+    /// Set the socket to blocking.
+    /// @return true if successful set to blocking, else return false;
+    bool SetBlocking(void);
+
+    /// Set the socket as non-blocking.
+    /// @return true if successful set to non-blocking, else return false;
+    bool SetNonblocking(void);
+
+    /// Get a pointer to internal receive buffer.  The user MUST not free this
+    /// pointer when finished.  This memory is managed internally by the CSocket
+    /// class.
+    /// @return pointer to data if valid, else returns NULL.
+    uint8 *GetData(void)  {
+        return m_pBuffer;
+    };
+
+    /// Returns the number of bytes received on the last call to
+    /// CSocket::Receive().
+    /// @return number of bytes received.
+    int32 GetBytesReceived(void) {
+        return m_nBytesReceived;
+    };
+
+    /// Returns the number of bytes sent on the last call to
+    /// CSocket::Send().
+    /// @return number of bytes sent.
+    int32 GetBytesSent(void) {
+        return m_nBytesSent;
+    };
+
+    /// Controls the actions taken when CSimpleSocket::Close is executed on a
+    /// socket object that has unsent data.  The default value for this option
+    /// is \b off.
+    /// - Following are the three possible scenarios.
+    ///  -# \b bEnable is false, CSimpleSocket::Close returns immediately, but
+    ///  any unset data is transmitted (after CSimpleSocket::Close returns)
+    ///  -# \b bEnable is true and \b nTime is zero, CSimpleSocket::Close return
+    /// immediately and any unsent data is discarded.
+    ///  -# \b bEnable is true and \b nTime is nonzero, CSimpleSocket::Close does
+    ///  not return until all unsent data is transmitted (or the connection is
+    ///  Closed by the remote system).
+    /// <br><p>
+    /// @param bEnable true to enable option false to disable option.
+    /// @param nTime time in seconds to linger.
+    /// @return true if option successfully set
+    bool SetOptionLinger(bool bEnable, uint16 nTime);
+
+    /// Tells the kernel that even if this port is busy (in the TIME_WAIT state),
+    /// go ahead and reuse it anyway.  If it is busy, but with another state,
+    /// you will still get an address already in use error.
+    /// @return true if option successfully set
+    bool SetOptionReuseAddr();
+
+    /// Gets the timeout value that specifies the maximum number of seconds a
+    /// call to CSimpleSocket::Open waits until it completes.
+    /// @return the length of time in seconds
+    int32 GetConnectTimeoutSec(void) {
+        return  m_stConnectTimeout.tv_sec;
+    };
+
+    /// Gets the timeout value that specifies the maximum number of microseconds
+    /// a call to CSimpleSocket::Open waits until it completes.
+    /// @return the length of time in microseconds
+    int32 GetConnectTimeoutUSec(void) {
+        return  m_stConnectTimeout.tv_usec;
+    };
+
+    /// Sets the timeout value that specifies the maximum amount of time a call
+    /// to CSimpleSocket::Receive waits until it completes. Use the method
+    /// CSimpleSocket::SetReceiveTimeout to specify the number of seconds to wait.
+    /// If a call to CSimpleSocket::Receive has blocked for the specified length of
+    /// time without receiving additional data, it returns with a partial count
+    /// or CSimpleSocket::GetSocketError set to CSimpleSocket::SocketEwouldblock if no data
+    /// were received.
+    /// @param nConnectTimeoutSec of timeout in seconds.
+    /// @param nConnectTimeoutUsec of timeout in microseconds.
+    /// @return true if socket connection timeout was successfully set.
+    void SetConnectTimeout(int32 nConnectTimeoutSec, int32 nConnectTimeoutUsec = 0)
+    {
+        m_stConnectTimeout.tv_sec = nConnectTimeoutSec;
+        m_stConnectTimeout.tv_usec = nConnectTimeoutUsec;
+    };
+
+    /// Gets the timeout value that specifies the maximum number of seconds a
+    /// a call to CSimpleSocket::Receive waits until it completes.
+    /// @return the length of time in seconds
+    int32 GetReceiveTimeoutSec(void) {
+        return  m_stRecvTimeout.tv_sec;
+    };
+
+    /// Gets the timeout value that specifies the maximum number of microseconds
+    /// a call to CSimpleSocket::Receive waits until it completes.
+    /// @return the length of time in microseconds
+    int32 GetReceiveTimeoutUSec(void) {
+        return  m_stRecvTimeout.tv_usec;
+    };
+
+    /// Sets the timeout value that specifies the maximum amount of time a call
+    /// to CSimpleSocket::Receive waits until it completes. Use the method
+    /// CSimpleSocket::SetReceiveTimeout to specify the number of seconds to wait.
+    /// If a call to CSimpleSocket::Receive has blocked for the specified length of
+    /// time without receiving additional data, it returns with a partial count
+    /// or CSimpleSocket::GetSocketError set to CSimpleSocket::SocketEwouldblock if no data
+    /// were received.
+    ///  @param nRecvTimeoutSec of timeout in seconds.
+    ///  @param nRecvTimeoutUsec of timeout in microseconds.
+    ///  @return true if socket timeout was successfully set.
+    bool SetReceiveTimeout(int32 nRecvTimeoutSec, int32 nRecvTimeoutUsec = 0);
+
+    /// Enable/disable multicast for a socket.  This options is only valid for
+    /// socket descriptors of type CSimpleSocket::SocketTypeUdp.
+    /// @return true if multicast was enabled or false if socket type is not
+    /// CSimpleSocket::SocketTypeUdp and the error will be set to
+    /// CSimpleSocket::SocketProtocolError
+    bool SetMulticast(bool bEnable, uint8 multicastTTL = 1);
+
+    /// Return true if socket is multicast or false is socket is unicast
+    /// @return true if multicast is enabled
+    bool GetMulticast() {
+        return m_bIsMulticast;
+    };
+
+    /// Bind socket to a specific interface when using multicast.
+    /// @return true if successfully bound to interface
+    bool BindInterface(const char *pInterface);
+
+    /// Gets the timeout value that specifies the maximum number of seconds a
+    /// a call to CSimpleSocket::Send waits until it completes.
+    /// @return the length of time in seconds
+    int32 GetSendTimeoutSec(void) {
+        return  m_stSendTimeout.tv_sec;
+    };
+
+    /// Gets the timeout value that specifies the maximum number of microseconds
+    /// a call to CSimpleSocket::Send waits until it completes.
+    /// @return the length of time in microseconds
+    int32 GetSendTimeoutUSec(void) {
+        return  m_stSendTimeout.tv_usec;
+    };
+
+    /// Gets the timeout value that specifies the maximum amount of time a call
+    /// to CSimpleSocket::Send waits until it completes.
+    /// @return the length of time in seconds
+    bool SetSendTimeout(int32 nSendTimeoutSec, int32 nSendTimeoutUsec = 0);
+
+    /// Returns the last error that occured for the instace of the CSimpleSocket
+    /// instance.  This method should be called immediately to retrieve the
+    /// error code for the failing mehtod call.
+    ///  @return last error that occured.
+    CSocketError GetSocketError(void) {
+        return m_socketErrno;
+    };
+
+    /// Get the total time the of the last operation in milliseconds.
+    ///  @return number of milliseconds of last operation.
+    uint32 GetTotalTimeMs() {
+        return m_timer.GetMilliSeconds();
+    };
+
+    /// Get the total time the of the last operation in microseconds.
+    ///  @return number of microseconds or last operation.
+    uint32 GetTotalTimeUsec() {
+        return m_timer.GetMicroSeconds();
+    };
+
+    /// Return Differentiated Services Code Point (DSCP) value currently set on the socket object.
+    /// @return DSCP for current socket object.
+    /// <br><br> \b NOTE: Windows special notes http://support.microsoft.com/kb/248611.
+    int GetSocketDscp(void);
+
+    /// Set Differentiated Services Code Point (DSCP) for socket object.
+    ///  @param nDscp value of TOS setting which will be converted to DSCP
+    ///  @return true if DSCP value was properly set
+    /// <br><br> \b NOTE: Windows special notes http://support.microsoft.com/kb/248611.
+    bool SetSocketDscp(int nDscp);
+
+    /// Return socket descriptor
+    ///  @return socket descriptor which is a signed 32 bit integer.
+    SOCKET GetSocketDescriptor() {
+        return m_socket;
+    };
+
+    /// Return socket descriptor
+    ///  @return socket descriptor which is a signed 32 bit integer.
+    CSocketType GetSocketType() {
+        return m_nSocketType;
+    };
+
+    /// Returns clients Internet host address as a string in standard numbers-and-dots notation.
+    ///  @return NULL if invalid
+    const char *GetClientAddr() {
+        return inet_ntoa(m_stClientSockaddr.sin_addr);
+    };
+
+    /// Returns the port number on which the client is connected.
+    ///  @return client port number.
+    uint16 GetClientPort() {
+        return m_stClientSockaddr.sin_port;
+    };
+
+    /// Returns server Internet host address as a string in standard numbers-and-dots notation.
+    ///  @return NULL if invalid
+    const char *GetServerAddr() {
+        return inet_ntoa(m_stServerSockaddr.sin_addr);
+    };
+
+    /// Returns the port number on which the server is connected.
+    ///  @return server port number.
+    uint16 GetServerPort() {
+        return ntohs(m_stServerSockaddr.sin_port);
+    };
+
+    /// Get the TCP receive buffer window size for the current socket object.
+    /// <br><br>\b NOTE: Linux will set the receive buffer to twice the value passed.
+    ///  @return zero on failure else the number of bytes of the TCP receive buffer window size if successful.
+    uint32 GetReceiveWindowSize() {
+        return GetWindowSize(SO_RCVBUF);
+    };
+
+    /// Get the TCP send buffer window size for the current socket object.
+    /// <br><br>\b NOTE: Linux will set the send buffer to twice the value passed.
+    ///  @return zero on failure else the number of bytes of the TCP receive buffer window size if successful.
+    uint32 GetSendWindowSize() {
+        return GetWindowSize(SO_SNDBUF);
+    };
+
+    /// Set the TCP receive buffer window size for the current socket object.
+    /// <br><br>\b NOTE: Linux will set the receive buffer to twice the value passed.
+    ///  @return zero on failure else the number of bytes of the TCP send buffer window size if successful.
+    uint32 SetReceiveWindowSize(uint32 nWindowSize) {
+        return SetWindowSize(SO_RCVBUF, nWindowSize);
+    };
+
+    /// Set the TCP send buffer window size for the current socket object.
+    /// <br><br>\b NOTE: Linux will set the send buffer to twice the value passed.
+    ///  @return zero on failure else the number of bytes of the TCP send buffer window size if successful.
+    uint32 SetSendWindowSize(uint32 nWindowSize) {
+        return SetWindowSize(SO_SNDBUF, nWindowSize);
+    };
+
+    /// Disable the Nagle algorithm (Set TCP_NODELAY to true)
+    /// @return false if failed to set socket option otherwise return true;
+    bool DisableNagleAlgoritm();
+
+    /// Enable the Nagle algorithm (Set TCP_NODELAY to false)
+    /// @return false if failed to set socket option otherwise return true;
+    bool EnableNagleAlgoritm();
+
+
+protected:
+    /// Set internal socket error to that specified error
+    ///  @param error type of error
+    void SetSocketError(CSimpleSocket::CSocketError error) {
+        m_socketErrno = error;
+    };
+
+    /// Set object socket handle to that specified as parameter
+    ///  @param socket value of socket descriptor
+    void SetSocketHandle(SOCKET socket) {
+        m_socket = socket;
+    };
+
+private:
+    /// Generic function used to get the send/receive window size
+    ///  @return zero on failure else the number of bytes of the TCP window size if successful.
+    uint32 GetWindowSize(uint32 nOptionName);
+
+    /// Generic function used to set the send/receive window size
+    ///  @return zero on failure else the number of bytes of the TCP window size if successful.
+    uint32 SetWindowSize(uint32 nOptionName, uint32 nWindowSize);
+
+
+    /// Attempts to send at most nNumItem blocks described by sendVector
+    /// to the socket descriptor associated with the socket object.
+    /// @param sendVector pointer to an array of iovec structures
+    /// @param nNumItems number of items in the vector to process
+    /// <br>\b Note: This implementation is for systems that don't natively
+    /// support this functionality.
+    /// @return number of bytes actually sent, return of zero means the
+    /// connection has been shutdown on the other side, and a return of -1
+    /// means that an error has occurred.
+    int32 Writev(const struct iovec *pVector, size_t nCount);
+
+    /// Flush the socket descriptor owned by the object.
+    /// @return true data was successfully sent, else return false;
+    bool Flush();
+
+    CSimpleSocket *operator=(CSimpleSocket &socket);
+
+protected:
+    SOCKET               m_socket;            /// socket handle
+    CSocketError         m_socketErrno;       /// number of last error
+    uint8               *m_pBuffer;           /// internal send/receive buffer
+    int32                m_nBufferSize;       /// size of internal send/receive buffer
+    int32                m_nSocketDomain;     /// socket type PF_INET, PF_INET6
+    CSocketType          m_nSocketType;       /// socket type - UDP, TCP or RAW
+    int32                m_nBytesReceived;    /// number of bytes received
+    int32                m_nBytesSent;        /// number of bytes sent
+    uint32               m_nFlags;            /// socket flags
+    bool                 m_bIsBlocking;       /// is socket blocking
+    bool                 m_bIsMulticast;      /// is the UDP socket multicast;
+    struct timeval       m_stConnectTimeout;  /// connection timeout
+    struct timeval       m_stRecvTimeout;     /// receive timeout
+    struct timeval       m_stSendTimeout;     /// send timeout
+    struct sockaddr_in   m_stServerSockaddr;  /// server address
+    struct sockaddr_in   m_stClientSockaddr;  /// client address
+    struct sockaddr_in   m_stMulticastGroup;  /// multicast group to bind to
+    struct linger        m_stLinger;          /// linger flag
+    CStatTimer           m_timer;             /// internal statistics.
+#ifdef WIN32
+    WSADATA              m_hWSAData;          /// Windows
+#endif
+    fd_set               m_writeFds;          /// write file descriptor set
+    fd_set               m_readFds;           /// read file descriptor set
+    fd_set               m_errorFds;          /// error file descriptor set
+};
+
+
+#endif /*  __SOCKET_H__  */
+

+ 114 - 0
pico-tcp-service/pico-tcp-client/src/StatTimer.h

@@ -0,0 +1,114 @@
+/*----------------------------------------------------------------------------*/
+/*                                                                            */
+/* StatTimer.h: interface for the CStatTimer class.                           */
+/*                                                                            */
+/* Author: Mark Carrier (mark@carrierlabs.com)                                */
+/*                                                                            */
+/*----------------------------------------------------------------------------*/
+/* Copyright (c) 2006 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#ifndef __CSTATTIMER_H__
+#define __CSTATTIMER_H__
+
+#include <string.h>
+
+#if WIN32
+  #include <Winsock2.h>
+  #include <time.h>
+#endif
+
+#ifdef _LINUX
+  #include <stdio.h>
+  #include <sys/time.h>
+#endif
+
+#include "Host.h"
+
+#if defined(WIN32)
+  #define GET_CLOCK_COUNT(x) QueryPerformanceCounter((LARGE_INTEGER *)x)
+#else
+  #define GET_CLOCK_COUNT(x) gettimeofday(x, NULL)
+#endif
+
+#define MILLISECONDS_CONVERSION 1000
+#define MICROSECONDS_CONVERSION 1000000
+
+/// Class to abstract socket communications in a cross platform manner.
+/// This class is designed
+class EXPORT CStatTimer {
+public:
+    CStatTimer()
+    {
+    };
+
+    ~CStatTimer()
+    {
+    };
+
+    void Initialize()
+    {
+        memset(&m_startTime, 0, sizeof(struct timeval));
+        memset(&m_endTime, 0, sizeof(struct timeval));
+    };
+
+    struct timeval GetStartTime() { return m_startTime; };
+    void SetStartTime() { GET_CLOCK_COUNT(&m_startTime); };
+
+    struct timeval GetEndTime() { return m_endTime; };
+    void SetEndTime() { GET_CLOCK_COUNT(&m_endTime); };
+
+    uint32 GetMilliSeconds() { return (CalcTotalUSec() / MILLISECONDS_CONVERSION); };
+    uint32 GetMicroSeconds() { return (CalcTotalUSec()); };
+    uint32 GetSeconds() { return (CalcTotalUSec() / MICROSECONDS_CONVERSION); };
+
+    uint32 GetCurrentTime()
+    {
+        struct timeval tmpTime;
+        GET_CLOCK_COUNT(&tmpTime);
+        return ((tmpTime.tv_sec * MICROSECONDS_CONVERSION) + tmpTime.tv_usec);
+    };
+
+private:
+    uint32 CalcTotalUSec() { return (((m_endTime.tv_sec - m_startTime.tv_sec) * MICROSECONDS_CONVERSION) +
+                                    (m_endTime.tv_usec - m_startTime.tv_usec)); };
+
+
+private:
+    struct timeval  m_startTime;
+    struct timeval  m_endTime;
+};
+
+#endif // __CSTATTIMER_H__

+ 466 - 0
pico-tcp-service/pico-tcp-client/src/requests.cpp

@@ -0,0 +1,466 @@
+#pragma once
+#include <iostream>
+#include <fstream>
+#include <vector>
+#include <malloc.h>
+#include <algorithm>
+#include <thread>
+#include <chrono>
+#include <sstream>
+#include <string>
+#include <iomanip>
+#include <cstdint>
+#include <bitset>
+#include "simplelogger.hpp"
+using namespace std;
+
+extern std::ostream out(std::cout.rdbuf());
+stringstream mystream;
+extern SimpleLogger newlogger = SimpleLogger(out, "sync");
+SimpleLogger errorlogger = SimpleLogger(cerr);
+SimpleLogger stringlogger = SimpleLogger(mystream);
+
+namespace request
+{
+constexpr size_t MAX_PACKET{4096};
+const int32_t NODES_PER_PACKET{200};          // Number of points for 1 package
+const uint32_t PACKETS_WO_CONFIRM{1};        // How many packages could be sent without confirmation
+const double CONFIRM_TIMEOUT_SEC{0.1};
+string hex_converting(int32_t num)
+{
+    stringlogger << hex << num;
+    if(num < 0)
+    {
+        return mystream.str().substr(4);
+    }
+    else
+    {
+        return mystream.str();
+    }
+}
+
+void ShowError(CSimpleSocket ss, string s)
+{
+
+    newlogger << " " << s << " : " << " = " << ss.DescribeError() << '\n';
+    newlogger << " IsSocketValid() = " << ss.IsSocketValid() << '\n\n';
+} //ShowError
+
+
+void get_API_version (CActiveSocket& SocketActive){ //This function send API version request and shows response
+    uint8 buf[MAX_PACKET] ;
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x0C);
+    buf[3] = uint8(0x00);
+
+    newlogger << "GET API VERSION";
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, 4) << '\n';
+    ShowError(SocketActive, "SocketActive.Send");
+
+
+    newlogger << "listening..." << '\n\n';
+    newlogger << "SocketActive.Receive = " << hex <<SocketActive.Receive(MAX_PACKET, buf) << '\n';
+    ShowError(SocketActive, "SocketActive.Receive");
+
+/// @return number of bytes actually received.
+/// @return of zero means the connection has been shutdown on the other side.
+/// @return of -1 means that an error has occurred.
+
+    newlogger << "Bytes Received : " ;
+    for(int32_t i=0; i<SocketActive.GetBytesReceived(); i++)
+        {
+            //cout << " buf[" << ii << "] = " << buf[ii] << " " << endl;
+            newlogger << hex << buf[i];
+        } //for
+        newlogger << '\n\n';
+}// get_API_version
+
+
+
+void get_sw_revision(CActiveSocket& SocketActive){ //This function send revision version request and shows response
+    uint8 buf[MAX_PACKET] ;
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x0D);
+    buf[3] = uint8(0x00);
+
+    newlogger << "GET SW REVISION";
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, 4) << '\n';
+    ShowError(SocketActive, "SocketActive.Send");
+
+
+    newlogger << "listening..." << '\n\n';
+    newlogger << "SocketActive.Receive = " << hex <<SocketActive.Receive(MAX_PACKET, buf) << '\n';
+    ShowError(SocketActive, "SocketActive.Receive");
+
+/// @return number of bytes actually received.
+/// @return of zero means the connection has been shutdown on the other side.
+/// @return of -1 means that an error has occurred.
+
+    newlogger << "Bytes Received : " ;
+    for(int32_t ii=0; ii<SocketActive.GetBytesReceived(); ii++)
+        {
+            //cout << " buf[" << ii << "] = " << buf[ii] << " " << endl;
+            newlogger << hex << buf[ii];
+        } //for
+        newlogger << '\n\n';
+}//get_sw_revision
+
+void get_gru_state(CActiveSocket& SocketActive){ //This function send request of state gradient amplifier and shows response
+    uint8 buf[MAX_PACKET] ;
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x05);
+    buf[3] = uint8(0x00);
+
+    newlogger << "GET GRU STATE";
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, 4) << '\n';
+    ShowError(SocketActive, "SocketActive.Send");
+
+
+    newlogger << "listening..." << '\n\n';
+    newlogger << "SocketActive.Receive = " << hex <<SocketActive.Receive(MAX_PACKET, buf) << '\n';
+    ShowError(SocketActive, "SocketActive.Receive");
+
+/// @return number of bytes actually received.
+/// @return of zero means the connection has been shutdown on the other side.
+/// @return of -1 means that an error has occurred.
+
+    newlogger << "Bytes Received : " ;
+    for(int32_t ii=0; ii<SocketActive.GetBytesReceived(); ii++)
+        {
+            //cout << " buf[" << ii << "] = " << buf[ii] << " " << '\n';
+            newlogger << hex << buf[ii];
+        } //for
+        newlogger << '\n\n';
+
+}//get_gru_state
+
+
+
+void socket_close(CActiveSocket SocketActive){ // This function closes socket
+newlogger << "SocketActive.Close() = " << SocketActive.Close() << '\n';
+    ShowError(SocketActive, "SocketActive.Close");
+    newlogger << "closed" << '\n';
+}
+
+vector<vector<int32_t>> get_nodes(const string& Traject_file_name) {
+    vector<vector<int32_t>> nodes;
+     ifstream myfile(Traject_file_name);
+    if (!myfile.is_open()) { // ��������, ������� �� ������ ����
+        errorlogger << "Unable to open file\n"; // ����� �� ��������� � �������
+    }
+    int32_t num1, num2;
+    while(myfile >> num1 >> num2) {
+        nodes.push_back({num1, num2});
+    }
+
+    return nodes;
+}//get nodes
+
+vector <int32_t> get_unloaded_num(vector<int32_t> segment_status){
+    vector <int32_t> res;
+    for (uint32_t i = 0; i< segment_status.size();i++){
+        if (segment_status[i] != 0){
+            res.push_back(i);
+        }
+    }
+    return res;
+
+}//get_unloaded_num
+
+//function to upload a segment of traject
+void upload_segment(CActiveSocket &SocketActive, int32_t seg_num, bool need_confirm, vector<vector<int32_t>> nodes)
+{
+    int32_t counter=0;
+    uint8 buf[MAX_PACKET]{0};
+    string str1 = hex_converting(seg_num);
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x07);
+    buf[3] = uint8(0x00);
+    counter+=4;
+
+    //data of segment traject
+    need_confirm = true;
+if(need_confirm)
+    {
+
+    buf[4] = uint8(stoi(str1, nullptr, 16));
+    buf[5] = uint8(0x80);
+    counter+=2;
+
+    }
+    else{
+        buf[4] = uint8(stoi(str1, nullptr, 16));
+        counter++;
+    }
+
+
+    int32_t NULL32=0;
+    int32_t NODES_SIZE = nodes.size();
+    int32_t first_node_idx = max( seg_num * NODES_PER_PACKET - seg_num, NULL32 );
+    int32_t last_node_idx = min( first_node_idx + NODES_PER_PACKET, NODES_SIZE) - 1;
+    int32_t nodes_in_this_packet = last_node_idx - first_node_idx + 1;
+
+    string str2 = hex_converting(nodes_in_this_packet);
+    buf[counter++] = uint8(stoi(str2, nullptr, 16));
+    buf[counter++] = uint8(0x00);
+
+    for(int i = first_node_idx; i <last_node_idx+1; i++)
+    {
+
+        string hexString1 = hex_converting(nodes[i][0]);
+        uint32_t tempcounter = counter;
+        string temp1, temp2;
+
+        for(int j = hexString1.length()-1; j > 0; j=j- 2)
+        {
+            buf[tempcounter++] = uint8(stoi(hexString1.substr(j-1,2), nullptr, 16) );
+        }
+        if(hexString1.length() % 2 != 0)
+        {
+            temp1 = hexString1[0];
+            hexString1.erase(0);
+            buf[tempcounter++] = uint8(stoi(temp1, nullptr, 16) );
+        }
+
+        counter+=4;
+
+        uint32_t tempcounter2 = counter;
+
+        string hexString2 = hex_converting(nodes[i][1]);
+
+        for(int j = hexString2.length()-1; j > 0; j -= 2)
+        {
+            buf[tempcounter2++] = uint8(stoi(hexString2.substr(j-1,2), nullptr, 16) );
+        }
+        if(hexString2.length() % 2 != 0)
+        {
+            temp2 = hexString2[0];
+            hexString1.erase(0);
+            buf[tempcounter2++] = uint8(stoi(temp2, nullptr, 16) );
+        }
+
+        counter+=2;
+    }
+
+
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, counter) << '\n';
+    ShowError(SocketActive, "SocketActive.Send");
+
+}
+
+void switch_func (string hexString, int32_t& counter, uint8 (&buf)[MAX_PACKET]){
+
+    switch(hexString.length())
+{
+    case 1:
+        {
+        buf[counter+1] = uint8(stoi(hexString, nullptr, 16));
+        break;
+        }
+
+    case 2:
+        {
+        buf[counter+1] = uint8(stoi(hexString, nullptr, 16));
+        break;
+        }
+    case 3:
+        {
+        string part1 = hexString.substr(0,1);
+        string part2 = hexString.substr(1);
+        buf[counter] = uint8(stoi(part2, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part1, nullptr, 16));
+        break;
+        }
+    case 4:
+        {
+        string part11 = hexString.substr(0,2);
+        string part22 = hexString.substr(2);
+        buf[counter] = uint8(stoi(part22, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part11, nullptr, 16));
+        break;
+        }
+
+    case 5:
+        {
+        string part11 = hexString.substr(0,2);
+        string part22 = hexString.substr(2,2);
+        string part31 = hexString.substr(4,1);
+        buf[counter] = uint8(stoi(part31, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part22, nullptr, 16));
+        buf[counter+2] = uint8(stoi(part11, nullptr, 16));
+        break;
+        }
+    case 6:
+        {
+        string part11 = hexString.substr(0,2);
+        string part22 = hexString.substr(2,2);
+        string part31 = hexString.substr(4,2);
+        buf[counter] = uint8(stoi(part31, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part22, nullptr, 16));
+        buf[counter+2] = uint8(stoi(part11, nullptr, 16));
+        break;
+        }
+    case 7:
+        {
+        string part11 = hexString.substr(0,2);
+        string part22 = hexString.substr(2,2);
+        string part31 = hexString.substr(4,2);
+        string part32 = hexString.substr(6,1);
+        buf[counter] = uint8(stoi(part32, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part31, nullptr, 16));
+        buf[counter+2] = uint8(stoi(part22, nullptr, 16));
+        buf[counter+3] = uint8(stoi(part11, nullptr, 16));
+        break;
+        }
+    case 8:
+        {
+        string part11 = hexString.substr(0,2);
+        string part22 = hexString.substr(2,2);
+        string part31 = hexString.substr(4,2);
+        string part32 = hexString.substr(6,2);
+        buf[counter] = uint8(stoi(part32, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part31, nullptr, 16));
+        buf[counter+2] = uint8(stoi(part22, nullptr, 16));
+        buf[counter+3] = uint8(stoi(part11, nullptr, 16));
+        break;
+        }
+}
+
+}
+
+void upload_traj(CActiveSocket& SocketActive, vector<vector<int32_t>> nodes){
+    //This function send trajectory to gradient amplifier
+    int32_t counter = 0;
+    uint8 buf[MAX_PACKET]{0} ;
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x06);
+    buf[3] = uint8(0x00);
+    counter+=4;
+
+    string hexString = hex_converting(nodes.size());
+    string hexString2 = hex_converting(nodes[nodes.size()-1][0]);
+
+    switch_func(hexString2, counter, buf);
+    counter+=4;
+    switch_func(hexString, counter, buf);
+    counter+=4;
+
+    newlogger << "UPLOADING TRAJECTORY";
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, 12) << '\n';
+    ShowError(SocketActive, "SocketActive.Send");
+
+    int32_t nodes_cnt = nodes.size();
+    int32_t segments_cnt = nodes_cnt / NODES_PER_PACKET; // segments_count
+
+    if (nodes_cnt % NODES_PER_PACKET != 0)
+        segments_cnt += 1;
+
+    vector<int32_t> segment_status(segments_cnt); //���������� �� ���������
+    segment_status.assign(segments_cnt, -2);
+    int32_t left_wo_confirm{PACKETS_WO_CONFIRM};
+
+    //bool confirm_timeout_detected = false;
+    //string prev_debug_info = " ";
+
+    vector <int32_t> uploaded_nums;
+    uploaded_nums = get_unloaded_num(segment_status);
+    int32_t counter_uploaded_nums = uploaded_nums.size()-1;
+
+    while (!uploaded_nums.empty()){
+
+        int32_t seg_num;
+        seg_num = uploaded_nums.back();
+        uploaded_nums.pop_back();
+
+        if (segment_status[seg_num] != -2){
+            newlogger << "Repeating upload segment" << seg_num << "with status" <<segment_status[seg_num] << '\n\n';
+        }//if
+
+        //����������� �� ������������� ������?
+
+        bool need_confirm = false;    //by default
+
+        if (left_wo_confirm == 0)
+            {
+            left_wo_confirm = PACKETS_WO_CONFIRM;
+            need_confirm = true;
+            }
+        else left_wo_confirm -= 1;    //for next iteration
+
+        if (seg_num == counter_uploaded_nums)
+            need_confirm = true;
+
+        upload_segment(SocketActive, seg_num, need_confirm, nodes);
+
+        this_thread::sleep_for(chrono::microseconds(10));
+    }//while
+
+
+}//upload_traj
+
+void download_traject (CActiveSocket &SocketActive, int32_t points_cnt)
+{
+    int32_t counter=0;
+    vector<int32_t> points;
+    uint8 buf[MAX_PACKET]{0} ;
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x09);
+    buf[3] = uint8(0x00);
+    buf[4] = uint8(0x00);
+    buf[5] = uint8(0x00);
+    buf[6] = uint8(0x00);
+    buf[7] = uint8(0x00);
+    counter+=8;
+    newlogger << hex << '\t' << points_cnt << '\n';
+    switch_func(hex_converting(points_cnt), counter, buf);
+    newlogger << "DOWNLOADING TRAJECTORY";
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, 12) << '\n\n';
+    ShowError(SocketActive, "SocketActive.Send");
+    uint32_t expected_packets_cnt = points_cnt / NODES_PER_PACKET;
+    if (points_cnt % NODES_PER_PACKET != 0)
+    {
+        expected_packets_cnt += 1;
+    }
+    vector<int32_t> downloaded_segments;
+    downloaded_segments.assign(expected_packets_cnt, 0);
+    points.assign(points_cnt, 0);
+    newlogger << "listening..." << '';
+    newlogger << "SocketActive.Receive = " << hex <<SocketActive.Receive(MAX_PACKET, buf) << '\n';
+    ShowError(SocketActive, "SocketActive.Receive");
+
+/// @return number of bytes actually received.
+/// @return of zero means the connection has been shutdown on the other side.
+/// @return of -1 means that an error has occurred.
+
+    newlogger << "Bytes Received : " ;
+    for(int32_t ii=0; ii<SocketActive.GetBytesReceived(); ii++)
+        {
+            //cout << " buf[" << ii << "] = " << buf[ii] << " " << endl;
+            newlogger << hex << buf[ii];
+        } //for
+        newlogger << '\n\n';
+
+    ofstream outFile("data.txt");
+    SimpleLogger filelogger = SimpleLogger(outFile);
+    if(!outFile.is_open())
+    {
+        errorlogger << "Error open file" << '\n';
+    }
+    for(int32_t ii=0; ii<SocketActive.GetBytesReceived(); ii++)
+        {
+            filelogger << buf[ii] << '\n';
+        } //for
+        outFile.close();
+}
+
+
+
+}
+
+

+ 23 - 0
pico-tcp-service/pico-tcp-client/src/requests.h

@@ -0,0 +1,23 @@
+#include "PassiveSocket.h"
+#include "requests.cpp"
+void ShowError(CSimpleSocket ss, string s);
+
+void get_API_version (CActiveSocket& SocketActive);
+
+void get_sw_revision(CActiveSocket& SocketActive);
+
+void get_gru_state(CActiveSocket& SocketActive);
+
+void socket_close(CActiveSocket SocketActive);
+
+vector <int32_t> get_unloaded_num(vector<int32_t> segment_status);
+
+void upload_segment(CActiveSocket &SocketActive, int32_t seg_num, bool need_confirm, vector<vector<int32_t>> nodes);
+
+void upload_traj(CActiveSocket& SocketActive, vector<vector<int32_t>> nodes);
+
+vector <int32_t> download_traject (CActiveSocket &SocketActive, int32_t points_cnt);
+
+vector<vector<int32_t>> get_nodes(const string& Traject_file_name);
+
+string hex_converting(int num);

+ 336 - 0
pico-tcp-service/pico-tcp-client/src/simplelogger.cpp

@@ -0,0 +1,336 @@
+#include "simplelogger.hpp"
+
+// Generates file name
+
+std::ostream& LogManip::setfill(std::ostream out, char c)
+{
+    out << std::setfill(c);
+    return out;
+}
+
+std::string SimpleLogger::generateFileName()
+{
+    std::chrono::time_point<std::chrono::system_clock> time_now = std::chrono::system_clock::now();
+    std::time_t t_n = std::chrono::system_clock::to_time_t(time_now);
+
+    char logfile_creation_time[100];
+    std::strftime(logfile_creation_time, sizeof(logfile_creation_time), "%Y%m%d-%H%M%S", std::localtime(&t_n));
+    std::string logname = this->log_name_prefix + "-log-" + std::string(logfile_creation_time, 100) + ".txt";
+
+    return logname;
+}
+
+// Generates prefix (in format of [TIME] / [FLAG]) for log string
+
+std::string SimpleLogger::generateLogString(int flag = INFO)
+{
+    auto time = std::chrono::system_clock::now(); // get the current time
+    std::time_t t = std::chrono::system_clock::to_time_t(time);
+
+    char log_time[100];
+    std::strftime(log_time, sizeof(log_time), "%Y-%m-%d %H:%M:%S", std::localtime(&t));
+
+    auto since_epoch = time.time_since_epoch(); // get the duration since epoch
+
+    auto time_millis = std::chrono::duration_cast<std::chrono::milliseconds>(since_epoch);
+    auto time_seconds = std::chrono::duration_cast<std::chrono::seconds>(since_epoch);
+
+    unsigned long long millis = time_millis.count() - 1000*time_seconds.count();
+
+    std::string logstring = std::string("[") + std::string(log_time) + std::string(":") + std::to_string(millis) + std::string("]");
+
+    switch(flag)
+    {
+    case ERROR:
+        logstring = logstring + " / [ERROR]\t";
+        break;
+    case WARN:
+        logstring = logstring + " / [WARN]\t";
+        break;
+    case INFO:
+        logstring = logstring + " / [INFO]\t";
+        break;
+    default:
+        logstring = logstring + " / [UNDEF]";
+        break;
+    }
+
+    return logstring;
+}
+
+// Main Constructors (we need to send reference to our main log stream)
+
+SimpleLogger::SimpleLogger(std::ostream& ls = std::cout, std::string prefix = "", std::string filename = "") : log_stream(ls)
+{
+    this->initializeLogger(filename, prefix);
+}
+
+SimpleLogger::SimpleLogger(std::ostream& ls = std::cout) : log_stream(ls)
+{
+    this->initializeLogger("", "some");
+}
+
+SimpleLogger::SimpleLogger(std::ostream& ls, std::string prefix) : log_stream(ls)
+{
+    this->initializeLogger("", prefix);
+}
+
+
+void SimpleLogger::initializeLogger(std::string filename = "", std::string prefix = "")
+{
+    this->log_flag.flag = INFO;
+    this->log_name_prefix = prefix;
+    this->log_string = "";
+    this->console_enabled = false;
+
+    if(filename == "")
+    {
+        this->log_name = generateFileName();
+    }
+    else
+    {
+        this->log_name = prefix + filename;
+    }
+
+    this->file_stream.open(this->log_name);
+    this->log_stream.rdbuf(this->file_stream.rdbuf());
+}
+
+SimpleLogger::SimpleLogger(const SimpleLogger& other) : log_stream(other.log_stream)
+{
+    this->log_flag = other.log_flag;
+    this->log_name_prefix = other.log_name_prefix;
+    this->log_string = other.log_string;
+    this->console_enabled = other.console_enabled;
+    this->log_name = other.log_name;
+}
+
+void SimpleLogger::closeLogger()
+{
+    this->log_stream.rdbuf(cout.rdbuf());
+    this->file_stream.close();
+}
+
+SimpleLogger::~SimpleLogger()
+{
+    this->closeLogger();
+}
+
+void SimpleLogger::setLoggerFlag(LogPref::Flag log_flag = LogPref::Flag(INFO))
+{
+    this->log_flag = log_flag;
+}
+
+void SimpleLogger::enableConsoleOutput(bool enable_console)
+{
+    console_enabled = enable_console;
+}
+
+SimpleLogger SimpleLogger::operator<<(LogPref::Flag flag)
+{
+    SimpleLogger s(*this);
+    s.setLoggerFlag(flag);
+    return s;
+}
+
+SimpleLogger SimpleLogger::operator<<(bool val){
+    if(console_enabled){
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned long long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(double val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long double val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const void* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::nullptr_t) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << "nullptr";
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << "nullptr";
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(short val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(int val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned short val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned int val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(float val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::streambuf *sb) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << sb;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << sb;;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::ios_base& (*func)(std::ios_base&)) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::ostream& (*func)(std::ostream&)) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::_Setfill<char> func)
+{
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::_Setw func)
+{
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::string val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const signed char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const unsigned char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const char val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const unsigned char val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}

+ 86 - 0
pico-tcp-service/pico-tcp-client/src/simplelogger.hpp

@@ -0,0 +1,86 @@
+#include <iostream>
+#include <iomanip>
+#include <chrono>
+#include <ctime>
+#include <sstream>
+#include <fstream>
+#include <sstream>
+#include <fstream>
+
+#define ERROR -1 // Logger flags
+#define WARN 1
+#define INFO 0
+#define NO_LOG_STRING 2
+
+#ifndef SIMPLELOGGER_HPP
+#define SIMPLELOGGER_HPP
+namespace LogPref
+{
+class Flag {
+public:
+    int flag;
+    Flag(int flag) {this->flag = flag;}
+    Flag() {this->flag = INFO;}
+};
+}
+
+namespace LogManip
+{
+std::ostream& setfill(std::ostream out, char c);
+}
+
+class SimpleLogger {
+
+protected:
+    std::ostream& log_stream;
+    std::ofstream file_stream;
+
+    std::string log_name;
+    std::string log_name_prefix;
+    std::string log_string;
+    LogPref::Flag log_flag;
+    bool console_enabled;
+
+    std::string generateFileName();
+    std::string generateLogString(int flag);
+
+public:
+    SimpleLogger(std::ostream& ls, std::string prefix, std::string filename);
+    SimpleLogger(std::ostream& ls, std::string prefix);
+    SimpleLogger(std::ostream& ls);
+    SimpleLogger(const SimpleLogger& other);
+    void initializeLogger(std::string filename, std::string prefix);
+    void closeLogger();
+    void enableConsoleOutput(bool enable_console);
+    void setLoggerFlag(LogPref::Flag log_flag);
+    ~SimpleLogger();
+
+    SimpleLogger operator<<(LogPref::Flag flag);
+    SimpleLogger operator<<(bool val);
+    SimpleLogger operator<<(long val);
+    SimpleLogger operator<<(unsigned long val);
+    SimpleLogger operator<<(long long val);
+    SimpleLogger operator<<(unsigned long long val);
+    SimpleLogger operator<<(double val);
+    SimpleLogger operator<<(long double val);
+    SimpleLogger operator<<(const void* val);
+    SimpleLogger operator<<(std::nullptr_t);
+    SimpleLogger operator<<(short val);
+    SimpleLogger operator<<(int val);
+    SimpleLogger operator<<(unsigned short val);
+    SimpleLogger operator<<(unsigned int val);
+    SimpleLogger operator<<(float val);
+    SimpleLogger operator<<(std::streambuf *sb);
+    SimpleLogger operator<<(std::ios_base& (*func)(std::ios_base&));
+    SimpleLogger operator<<(std::ostream& (*func)(std::ostream&));
+    SimpleLogger operator<<(std::_Setfill<char> func);
+    SimpleLogger operator<<(std::_Setw func);
+    SimpleLogger operator<<(std::string val);
+    SimpleLogger operator<<(const char* val);
+    SimpleLogger operator<<(const signed char* val);
+    SimpleLogger operator<<(const unsigned char* val);
+    SimpleLogger operator<<(const char val);
+    SimpleLogger operator<<(const unsigned char val);
+};
+
+#endif // SIMPLELOGGER_HPP

+ 1 - 0
pico-tcp-service/pico-tcp/.gitignore

@@ -0,0 +1 @@
+.qodo

+ 57 - 0
pico-tcp-service/pico-tcp/.vscode/settings.json

@@ -0,0 +1,57 @@
+{
+    "files.associations": {
+        "tuple": "cpp",
+        "utility": "cpp",
+        "algorithm": "cpp",
+        "xstring": "cpp",
+        "ostream": "cpp",
+        "ios": "cpp",
+        "vector": "cpp",
+        "xutility": "cpp",
+        "atomic": "cpp",
+        "bitset": "cpp",
+        "cctype": "cpp",
+        "chrono": "cpp",
+        "cmath": "cpp",
+        "compare": "cpp",
+        "concepts": "cpp",
+        "cstddef": "cpp",
+        "cstdint": "cpp",
+        "cstdio": "cpp",
+        "cstdlib": "cpp",
+        "cstring": "cpp",
+        "ctime": "cpp",
+        "cwchar": "cpp",
+        "exception": "cpp",
+        "fstream": "cpp",
+        "initializer_list": "cpp",
+        "iomanip": "cpp",
+        "iosfwd": "cpp",
+        "iostream": "cpp",
+        "istream": "cpp",
+        "iterator": "cpp",
+        "limits": "cpp",
+        "memory": "cpp",
+        "new": "cpp",
+        "ratio": "cpp",
+        "sstream": "cpp",
+        "stdexcept": "cpp",
+        "streambuf": "cpp",
+        "string": "cpp",
+        "system_error": "cpp",
+        "thread": "cpp",
+        "type_traits": "cpp",
+        "typeinfo": "cpp",
+        "xfacet": "cpp",
+        "xiosbase": "cpp",
+        "xlocale": "cpp",
+        "xlocinfo": "cpp",
+        "xlocmon": "cpp",
+        "xlocnum": "cpp",
+        "xloctime": "cpp",
+        "xmemory": "cpp",
+        "xstddef": "cpp",
+        "xtr1common": "cpp"
+    },
+    "C_Cpp.errorSquiggles": "disabled"
+}

BIN
pico-tcp-service/pico-tcp/Owin.dll


BIN
pico-tcp-service/pico-tcp/bin/Debug/pico-tcp.exe


+ 254 - 0
pico-tcp-service/pico-tcp/inc/HRDL.h

@@ -0,0 +1,254 @@
+/****************************************************************************
+*
+* Filename:    HRDL.h
+* Author:			 MAS
+* Description:
+*
+* This header defines the interface to driver routines for the PicoLog
+*	High Resolution Data Logger Series.
+*
+* Copyright © 2004-2018 Pico Technology Ltd. All rights reserved.
+*
+****************************************************************************/
+#pragma once
+
+#include <stdint.h>
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+	#define TYPE_ENUM enum
+#endif
+
+#ifdef WIN32
+	//	If you are dynamically linking hrdl.dll into your project #define DYNLINK
+	//  somewhere in your project before here.
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (__stdcall *x)
+	#else
+		#define PREF1
+		#ifdef _USRDLL
+			#define PREF2 __declspec(dllexport) __stdcall
+		#else
+			#define PREF2 __declspec(dllimport) __stdcall
+		#endif
+		#define PREF3(x) x
+	#endif
+#else
+	/* Define a 64-bit integer type */
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+  #define __stdcall
+#endif
+
+#define HRDL_MAX_PICO_UNITS 64
+#define HRDL_MAX_UNITS 20
+
+typedef enum enHRDLInputs
+{
+  HRDL_DIGITAL_CHANNELS,
+  HRDL_ANALOG_IN_CHANNEL_1,
+  HRDL_ANALOG_IN_CHANNEL_2,
+  HRDL_ANALOG_IN_CHANNEL_3,
+  HRDL_ANALOG_IN_CHANNEL_4,
+  HRDL_ANALOG_IN_CHANNEL_5,
+  HRDL_ANALOG_IN_CHANNEL_6,
+  HRDL_ANALOG_IN_CHANNEL_7,
+  HRDL_ANALOG_IN_CHANNEL_8,
+  HRDL_ANALOG_IN_CHANNEL_9,
+  HRDL_ANALOG_IN_CHANNEL_10,
+  HRDL_ANALOG_IN_CHANNEL_11,
+  HRDL_ANALOG_IN_CHANNEL_12,
+  HRDL_ANALOG_IN_CHANNEL_13,
+  HRDL_ANALOG_IN_CHANNEL_14,
+  HRDL_ANALOG_IN_CHANNEL_15,
+  HRDL_ANALOG_IN_CHANNEL_16,
+  HRDL_MAX_ANALOG_CHANNELS = HRDL_ANALOG_IN_CHANNEL_16,
+} HRDL_INPUTS;
+
+typedef enum enHRDLDigitalIoChannel
+{   
+  HRDL_DIGITAL_IO_CHANNEL_1 = 0x01,
+  HRDL_DIGITAL_IO_CHANNEL_2 = 0x02,
+  HRDL_DIGITAL_IO_CHANNEL_3 = 0x04,
+  HRDL_DIGITAL_IO_CHANNEL_4 = 0x08,
+  HRDL_MAX_DIGITAL_CHANNELS = 4
+} HRDL_DIGITAL_IO_CHANNEL;
+
+typedef enum enHRDLRange
+{
+  HRDL_2500_MV,
+  HRDL_1250_MV,
+  HRDL_625_MV,
+  HRDL_313_MV,
+  HRDL_156_MV,
+  HRDL_78_MV,
+  HRDL_39_MV,  
+  HRDL_MAX_RANGES
+}	HRDL_RANGE;
+
+typedef enum enHRDLConversionTime
+{
+  HRDL_60MS,
+  HRDL_100MS,
+  HRDL_180MS,
+  HRDL_340MS,
+  HRDL_660MS,
+  HRDL_MAX_CONVERSION_TIMES
+
+}	HRDL_CONVERSION_TIME;
+
+typedef enum enHRDLInfo
+{
+  HRDL_DRIVER_VERSION,
+  HRDL_USB_VERSION,
+  HRDL_HARDWARE_VERSION,
+  HRDL_VARIANT_INFO,
+  HRDL_BATCH_AND_SERIAL,
+  HRDL_CAL_DATE,	
+  HRDL_KERNEL_DRIVER_VERSION, 
+  HRDL_ERROR,
+	HRDL_SETTINGS,
+} HRDL_INFO;
+
+typedef enum enHRDLErrorCode
+{
+	HRDL_OK,
+	HRDL_KERNEL_DRIVER,
+	HRDL_NOT_FOUND,
+	HRDL_CONFIG_FAIL,
+	HRDL_ERROR_OS_NOT_SUPPORTED,
+	HRDL_MAX_DEVICES
+} HRDL_ERROR_CODES;
+
+
+typedef enum enSettingsError
+{
+	SE_CONVERSION_TIME_OUT_OF_RANGE,
+	SE_SAMPLEINTERVAL_OUT_OF_RANGE,
+	SE_CONVERSION_TIME_TOO_SLOW,
+	SE_CHANNEL_NOT_AVAILABLE,
+	SE_INVALID_CHANNEL,
+	SE_INVALID_VOLTAGE_RANGE,
+	SE_INVALID_PARAMETER,
+	SE_CONVERSION_IN_PROGRESS,
+	SE_COMMUNICATION_FAILED,
+	SE_OK,
+	SE_MAX = SE_OK
+} SettingsError;
+
+typedef enum enHRDLOpenProgress
+{
+  HRDL_OPEN_PROGRESS_FAIL     = -1,
+  HRDL_OPEN_PROGRESS_PENDING  = 0,
+  HRDL_OPEN_PROGRESS_COMPLETE = 1
+} HRDL_OPEN_PROGRESS;
+
+typedef enum enBlockMethod
+{
+  HRDL_BM_BLOCK,
+  HRDL_BM_WINDOW,
+  HRDL_BM_STREAM
+} HRDL_BLOCK_METHOD;
+
+
+#define INVALID_HRDL_VALUE 0xF0000000
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLOpenUnit)	 ( void );
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLOpenUnitAsync) (void);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLOpenUnitProgress) (int16_t * handle, int16_t * progress);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLGetUnitInfo) (
+															int16_t handle,
+															int8_t * string,
+															int16_t stringLength,
+															int16_t info);
+
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLCloseUnit) ( int16_t handle );
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLGetMinMaxAdcCounts)(int16_t handle, int32_t * minAdc, int32_t * maxAdc, int16_t channel);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLSetAnalogInChannel) (int16_t handle, int16_t channel, int16_t enabled, int16_t	range, int16_t singleEnded);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLSetDigitalIOChannel) (int16_t handle, int16_t directionOut, int16_t digitalOutPinState, int16_t enabledDigitalIn);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLSetInterval)(int16_t handle, int32_t sampleInterval_ms, int16_t conversionTime);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLRun) (int16_t handle, int32_t	nValues, int16_t	method);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLReady) (int16_t handle);
+
+PREF0 PREF1 void PREF2  PREF3(HRDLStop)(int16_t handle);
+
+PREF0 PREF1 int32_t PREF2 PREF3(HRDLGetValues) (
+  int16_t handle,
+  int32_t * values,
+  int16_t * overflow,
+  int32_t no_of_values);
+
+PREF0 PREF1 int32_t PREF2 PREF3(HRDLGetTimesAndValues) (
+  int16_t handle,
+  int32_t  * times,
+  int32_t * values,
+  int16_t * overflow,
+  int32_t noOfValues);
+
+
+// this routine blocks other functions until it returns
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLGetSingleValue) (
+  int16_t handle,
+  int16_t channel,
+	int16_t	range,
+	int16_t conversionTime,
+	int16_t singleEnded,
+	int16_t *overflow,
+	int32_t *value); 
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLCollectSingleValueAsync) (
+  int16_t handle,
+  int16_t channel,
+	int16_t	range,
+	int16_t conversionTime,
+	int16_t singleEnded
+	); 
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLGetSingleValueAsync) (
+  int16_t handle,
+	int32_t *value,
+	int16_t *overflow); 
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLSetMains)(int16_t handle, int16_t sixtyHertz);
+
+PREF0 PREF1 int16_t PREF2 PREF3(HRDLGetNumberOfEnabledChannels)(int16_t handle, int16_t * nEnabledChannels);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (HRDLAcknowledge)(int16_t handle);

+ 68 - 0
pico-tcp-service/pico-tcp/inc/PicoCallback.h

@@ -0,0 +1,68 @@
+/****************************************************************************
+ *
+ * Filename:    PicoCallback.h
+ * Copyright:   Pico Technology Limited 2018 - 2022
+ * Description:
+ *
+ * This header contains definitions of various call back signatures used by
+ * the Picoscope drivers to asynchronously communicate.
+ *
+ ****************************************************************************/
+
+#ifndef __PICOCALLBACK_H__
+#define __PICOCALLBACK_H__
+
+#include <stdint.h>
+
+#include "PicoDeviceEnums.h"
+#include "PicoDeviceStructs.h"
+
+#ifdef WIN32
+#define PREF5 __stdcall
+#else
+#define PREF5
+#endif
+
+typedef void (PREF5 * PicoUpdateFirmwareProgress)
+(
+	int16_t        handle,
+	uint16_t			 progress
+	);
+
+typedef void (PREF5 *PicoProbeInteractions)
+(
+  int16_t    											handle,
+  PICO_STATUS											status,
+  PICO_USER_PROBE_INTERACTIONS *	probes,
+  uint32_t												nProbes
+);
+
+typedef void (PREF5 *PicoDataReadyUsingReads)
+(
+  int16_t    					handle,
+  PICO_READ_SELECTION read,
+  PICO_STATUS					status,
+  uint64_t						fromSegmentIndex,
+  uint64_t						toSegmentIndex,
+  PICO_POINTER				pParameter
+  );
+
+typedef void (PREF5 *PicoExternalReferenceInteractions)
+(
+  int16_t    											handle,
+  PICO_STATUS											status,
+  PICO_CLOCK_REFERENCE            reference
+  );
+
+typedef void (PREF5 *PicoAWGOverrangeInteractions)
+(
+  int16_t    											handle,
+  PICO_STATUS											status
+  );
+
+typedef void (PREF5 *PicoTemperatureSensorInteractions)
+(
+  int16_t    											handle,
+  PICO_TEMPERATURE_REFERENCE      temperatureStatus
+  );
+#endif

+ 271 - 0
pico-tcp-service/pico-tcp/inc/PicoConnectProbes.h

@@ -0,0 +1,271 @@
+/****************************************************************************
+ *
+ * Filename:    PicoConnectProbes.h
+ * Copyright:   Pico Technology Limited 2016 - 2022
+ * Description:
+ *
+ * This header defines enumerations relating to PicoConnect (TM)
+ * probes and the corresponding voltage/current ranges.
+ *
+ ****************************************************************************/
+
+#ifndef __PICOCONNECTPROBES_H__
+#define __PICOCONNECTPROBES_H__
+
+#include <stdint.h>
+
+typedef int32_t PicoConnectProbe;
+
+typedef enum enPicoConnectProbe
+{
+  PICO_CONNECT_PROBE_NONE = 0,
+
+  PICO_CONNECT_PROBE_D9_BNC = 4000,
+  PICO_CONNECT_PROBE_D9_2X_BNC,
+  PICO_CONNECT_PROBE_DIFFERENTIAL,
+  PICO_CONNECT_PROBE_CURRENT_CLAMP_200_2KA,
+  PICO_CONNECT_PROBE_CURRENT_CLAMP_40A,
+  PICO_CONNECT_PROBE_CAT3_HV_1KV,
+  PICO_CONNECT_PROBE_CURRENT_CLAMP_2000ARMS,
+
+  PICO_BNC_PLUS_PREMIUM_TEST_LEAD_BLUE = 4404,
+  PICO_BNC_PLUS_PREMIUM_TEST_LEAD_RED,
+  PICO_BNC_PLUS_PREMIUM_TEST_LEAD_GREEN,
+  PICO_BNC_PLUS_PREMIUM_TEST_LEAD_YELLOW,
+  PICO_BNC_PLUS_COP_PROBE,
+
+  PICO_BNC_PLUS_TEMPERATURE_PROBE = 5000,
+  PICO_BNC_PLUS_100A_CURRENT_CLAMP = 5003,
+  PICO_BNC_PLUS_HT_PICKUP = 5005,
+  PICO_BNC_PLUS_X10_SCOPE_PROBE = 5006,
+  PICO_BNC_PLUS_2000A_CURRENT_CLAMP = 5007,
+  PICO_BNC_PLUS_PRESSURE_SENSOR = 5008,
+  PICO_BNC_PLUS_RESISTANCE_LEAD = 5009,
+  PICO_BNC_PLUS_60A_CURRENT_CLAMP = 5010,
+  PICO_BNC_PLUS_OPTICAL_SENSOR = 5011,
+  PICO_BNC_PLUS_60A_CURRENT_CLAMP_V2 = 5012,
+  PICO_BNC_PLUS_HIGH_VOLTAGE_DIFFERENTIAL = 5013,
+
+  PICO_PASSIVE_PROBE_X10 = 6000,
+  PICO_ACTIVE_X10_750MHZ = 6001,
+  PICO_ACTIVE_X10_1_3GHZ = 6002,
+
+  PICO_CONNECT_PROBE_INTELLIGENT = -3,
+
+  PICO_CONNECT_PROBE_UNKNOWN_PROBE = -2,
+  PICO_CONNECT_PROBE_FAULT_PROBE = -1
+} PICO_CONNECT_PROBE;
+
+typedef enum enPicoConnectProbeRange
+{
+  PICO_X1_PROBE_10MV,
+  PICO_X1_PROBE_20MV,
+  PICO_X1_PROBE_50MV,
+  PICO_X1_PROBE_100MV,
+  PICO_X1_PROBE_200MV,
+  PICO_X1_PROBE_500MV,
+  PICO_X1_PROBE_1V,
+  PICO_X1_PROBE_2V,
+  PICO_X1_PROBE_5V,
+  PICO_X1_PROBE_10V,
+  PICO_X1_PROBE_20V,
+  PICO_X1_PROBE_50V,
+  PICO_X1_PROBE_100V,
+  PICO_X1_PROBE_200V,
+  PICO_X1_PROBE_RANGES = (PICO_X1_PROBE_200V + 1) - PICO_X1_PROBE_10MV,
+
+  PICO_X10_PROBE_100MV = 0x00000020,
+  PICO_X10_PROBE_200MV,
+  PICO_X10_PROBE_500MV,
+  PICO_X10_PROBE_1V,
+  PICO_X10_PROBE_2V,
+  PICO_X10_PROBE_5V,
+  PICO_X10_PROBE_10V,
+  PICO_X10_PROBE_20V,
+  PICO_X10_PROBE_50V,
+  PICO_X10_PROBE_100V,
+  PICO_X10_PROBE_200V,
+  PICO_X10_PROBE_500V,
+  PICO_X10_PROBE_RANGES = PICO_X10_PROBE_500V - PICO_X10_PROBE_100MV + 1,
+
+  PICO_PS4000A_RESISTANCE_315K = 0x00000200,
+  PICO_PS4000A_RESISTANCE_1100K,
+  PICO_PS4000A_RESISTANCE_10M,
+  PICO_PS4000A_MAX_RESISTANCE_RANGES = (PICO_PS4000A_RESISTANCE_10M + 1) - PICO_PS4000A_RESISTANCE_315K,
+  PICO_PS4000A_RESISTANCE_ADCV_FLAG = 0x10000000,
+
+  PICO_CONNECT_PROBE_OFF = 1024,
+
+  PICO_D9_BNC_10MV = 0,
+  PICO_D9_BNC_20MV,
+  PICO_D9_BNC_50MV,
+  PICO_D9_BNC_100MV,
+  PICO_D9_BNC_200MV,
+  PICO_D9_BNC_500MV,
+  PICO_D9_BNC_1V,
+  PICO_D9_BNC_2V,
+  PICO_D9_BNC_5V,
+  PICO_D9_BNC_10V,
+  PICO_D9_BNC_20V,
+  PICO_D9_BNC_50V,
+  PICO_D9_BNC_100V,
+  PICO_D9_BNC_200V,
+  PICO_MAX_D9_BNC_RANGES = (PICO_D9_BNC_200V + 1) - PICO_D9_BNC_10MV,
+
+
+  PICO_D9_2X_BNC_10MV = PICO_D9_BNC_10MV,
+  PICO_D9_2X_BNC_20MV = PICO_D9_BNC_20MV,
+  PICO_D9_2X_BNC_50MV = PICO_D9_BNC_50MV,
+  PICO_D9_2X_BNC_100MV = PICO_D9_BNC_100MV,
+  PICO_D9_2X_BNC_200MV = PICO_D9_BNC_200MV,
+  PICO_D9_2X_BNC_500MV = PICO_D9_BNC_500MV,
+  PICO_D9_2X_BNC_1V = PICO_D9_BNC_1V,
+  PICO_D9_2X_BNC_2V = PICO_D9_BNC_2V,
+  PICO_D9_2X_BNC_5V = PICO_D9_BNC_5V,
+  PICO_D9_2X_BNC_10V = PICO_D9_BNC_10V,
+  PICO_D9_2X_BNC_20V = PICO_D9_BNC_20V,
+  PICO_D9_2X_BNC_50V = PICO_D9_BNC_50V,
+  PICO_D9_2X_BNC_100V = PICO_D9_BNC_100V,
+  PICO_D9_2X_BNC_200V = PICO_D9_BNC_200V,
+  PICO_MAX_D9_2X_BNC_RANGES = (PICO_D9_2X_BNC_200V + 1) - PICO_D9_2X_BNC_10MV,
+
+
+  PICO_DIFFERENTIAL_10MV = PICO_D9_BNC_10MV,
+  PICO_DIFFERENTIAL_20MV = PICO_D9_BNC_20MV,
+  PICO_DIFFERENTIAL_50MV = PICO_D9_BNC_50MV,
+  PICO_DIFFERENTIAL_100MV = PICO_D9_BNC_100MV,
+  PICO_DIFFERENTIAL_200MV = PICO_D9_BNC_200MV,
+  PICO_DIFFERENTIAL_500MV = PICO_D9_BNC_500MV,
+  PICO_DIFFERENTIAL_1V = PICO_D9_BNC_1V,
+  PICO_DIFFERENTIAL_2V = PICO_D9_BNC_2V,
+  PICO_DIFFERENTIAL_5V = PICO_D9_BNC_5V,
+  PICO_DIFFERENTIAL_10V = PICO_D9_BNC_10V,
+  PICO_DIFFERENTIAL_20V = PICO_D9_BNC_20V,
+  PICO_DIFFERENTIAL_50V = PICO_D9_BNC_50V,
+  PICO_DIFFERENTIAL_100V = PICO_D9_BNC_100V,
+  PICO_DIFFERENTIAL_200V = PICO_D9_BNC_200V,
+  PICO_MAX_DIFFERENTIAL_RANGES = (PICO_DIFFERENTIAL_200V + 1) - PICO_DIFFERENTIAL_10MV,
+
+
+  PICO_CURRENT_CLAMP_200A_2kA_1A = 4000,
+  PICO_CURRENT_CLAMP_200A_2kA_2A,
+  PICO_CURRENT_CLAMP_200A_2kA_5A,
+  PICO_CURRENT_CLAMP_200A_2kA_10A,
+  PICO_CURRENT_CLAMP_200A_2kA_20A,
+  PICO_CURRENT_CLAMP_200A_2kA_50A,
+  PICO_CURRENT_CLAMP_200A_2kA_100A,
+  PICO_CURRENT_CLAMP_200A_2kA_200A,
+  PICO_CURRENT_CLAMP_200A_2kA_500A,
+  PICO_CURRENT_CLAMP_200A_2kA_1000A,
+  PICO_CURRENT_CLAMP_200A_2kA_2000A,
+  PICO_MAX_CURRENT_CLAMP_200A_2kA_RANGES = (PICO_CURRENT_CLAMP_200A_2kA_2000A + 1) - PICO_CURRENT_CLAMP_200A_2kA_1A,
+
+
+  PICO_CURRENT_CLAMP_40A_100mA = 5000,
+  PICO_CURRENT_CLAMP_40A_200mA,
+  PICO_CURRENT_CLAMP_40A_500mA,
+  PICO_CURRENT_CLAMP_40A_1A,
+  PICO_CURRENT_CLAMP_40A_2A,
+  PICO_CURRENT_CLAMP_40A_5A,
+  PICO_CURRENT_CLAMP_40A_10A,
+  PICO_CURRENT_CLAMP_40A_20A,
+  PICO_CURRENT_CLAMP_40A_40A,
+  PICO_MAX_CURRENT_CLAMP_40A_RANGES = (PICO_CURRENT_CLAMP_40A_40A + 1) - PICO_CURRENT_CLAMP_40A_100mA,
+
+  PICO_1KV_2_5V = 6003,
+  PICO_1KV_5V,
+  PICO_1KV_12_5V,
+  PICO_1KV_25V,
+  PICO_1KV_50V,
+  PICO_1KV_125V,
+  PICO_1KV_250V,
+  PICO_1KV_500V,
+  PICO_1KV_1000V,
+  PICO_MAX_1KV_RANGES = (PICO_1KV_1000V + 1) - PICO_1KV_2_5V,
+
+  PICO_CURRENT_CLAMP_2000ARMS_10A = 6500,
+  PICO_CURRENT_CLAMP_2000ARMS_20A,
+  PICO_CURRENT_CLAMP_2000ARMS_50A,
+  PICO_CURRENT_CLAMP_2000ARMS_100A,
+  PICO_CURRENT_CLAMP_2000ARMS_200A,
+  PICO_CURRENT_CLAMP_2000ARMS_500A,
+  PICO_CURRENT_CLAMP_2000ARMS_1000A,
+  PICO_CURRENT_CLAMP_2000ARMS_2000A,
+  PICO_CURRENT_CLAMP_2000ARMS_5000A,
+  PICO_CURRENT_CLAMP_2000ARMS_RANGES = (PICO_CURRENT_CLAMP_2000ARMS_5000A + 1) - PICO_CURRENT_CLAMP_2000ARMS_10A,
+
+  PICO_RESISTANCE_LEAD_NEG5_TO_20OHM = 7000,
+  PICO_RESISTANCE_LEAD_NEG50_TO_200OHM,
+  PICO_RESISTANCE_LEAD_NEG500_TO_2KOHM,
+  PICO_RESISTANCE_LEAD_NEG5K_TO_20KOHM,
+  PICO_RESISTANCE_LEAD_NEG50K_TO_LEAD_200KOHM,
+  PICO_RESISTANCE_LEAD_NEG500K_TO_LEAD_2MOHM,
+  PICO_RESISTANCE_LEAD_DIODE_TEST,
+  PICO_MAX_RESISTANCE_LEAD_RANGES = (PICO_RESISTANCE_LEAD_DIODE_TEST + 1) - PICO_RESISTANCE_LEAD_NEG50_TO_200OHM,
+
+  PICO_HT_NEG3_TO_5KV = 8950,
+  PICO_HT_NEG3_TO_10KV,
+  PICO_HT_NEG5_TO_20KV,
+  PICO_HT_NEG5_TO_50KV,
+  PICO_HT_NEG5_TO_100KV,
+  PICO_HT_NEG3_TO_5KV_INVERTED,
+  PICO_HT_NEG3_TO_10KV_INVERTED,
+  PICO_HT_NEG5_TO_20KV_INVERTED,
+  PICO_HT_NEG5_TO_50KV_INVERTED,
+  PICO_HT_NEG5_TO_100KV_INVERTED,
+  PICO_MAX_HT_RANGES = PICO_HT_NEG5_TO_100KV_INVERTED - PICO_HT_NEG3_TO_5KV + 1,
+
+  PICO_TEMPERATURE_NEG50_TO_150DEGC = 9000,
+
+  PICO_PRESSURE_SENSOR_NEG100000_TO_150000_PASCALS = 9100,
+  PICO_PRESSURE_SENSOR_NEG100000_TO_400000_PASCALS = 9101,
+  PICO_PRESSURE_SENSOR_NEG200000_TO_800000_PASCALS = 9102,
+  PICO_PRESSURE_SENSOR_NEG400000_TO_1600000_PASCALS = 9103,
+  PICO_PRESSURE_SENSOR_NEG400000_TO_3400000_PASCALS = 9104,
+  PICO_PRESSURE_SENSOR_NEG150000_TO_1350000_PASCALS = 9105,
+
+  PICO_CURRENT_CLAMP_100A_2_5A = 10000,
+  PICO_CURRENT_CLAMP_100A_5A,
+  PICO_CURRENT_CLAMP_100A_10A,
+  PICO_CURRENT_CLAMP_100A_25A,
+  PICO_CURRENT_CLAMP_100A_50A,
+  PICO_CURRENT_CLAMP_100A_100A,
+
+  PICO_CURRENT_CLAMP_60A_2A = 10500,
+  PICO_CURRENT_CLAMP_60A_5A,
+  PICO_CURRENT_CLAMP_60A_10A,
+  PICO_CURRENT_CLAMP_60A_20A,
+  PICO_CURRENT_CLAMP_60A_50A,
+  PICO_CURRENT_CLAMP_60A_60A,
+
+  PICO_OPTICAL_SENSOR_10V = 10550,
+
+  PICO_CURRENT_CLAMP_60A_V2_0_5A = 10600,
+  PICO_CURRENT_CLAMP_60A_V2_1A,
+  PICO_CURRENT_CLAMP_60A_V2_2A,
+  PICO_CURRENT_CLAMP_60A_V2_5A,
+  PICO_CURRENT_CLAMP_60A_V2_10A,
+  PICO_CURRENT_CLAMP_60A_V2_20A,
+  PICO_CURRENT_CLAMP_60A_V2_50A,
+  PICO_CURRENT_CLAMP_60A_V2_60A,
+
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_5V = 10650,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_10V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_20V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_50V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_100V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_200V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_500V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_1000V,
+  PICO_HIGH_VOLTAGE_DIFFERENTIAL_1400V,
+
+  PICO_X10_ACTIVE_PROBE_100MV = 10700,
+  PICO_X10_ACTIVE_PROBE_200MV,
+  PICO_X10_ACTIVE_PROBE_500MV,
+  PICO_X10_ACTIVE_PROBE_1V,
+  PICO_X10_ACTIVE_PROBE_2V,
+  PICO_X10_ACTIVE_PROBE_5V,
+
+} PICO_CONNECT_PROBE_RANGE;
+
+#endif

+ 46 - 0
pico-tcp-service/pico-tcp/inc/PicoDeviceDefinitionsExperimental.h

@@ -0,0 +1,46 @@
+/****************************************************************************
+ *
+ * Filename:    PicoDeviceDefinitionsExperimental.h
+ * Copyright:   Pico Technology Limited 2016 - 2022
+ * Description:
+ *
+ * This header contains definitions of enumerated types and structs which
+ * are at the beta stage of development and their signatures may change.
+ ****************************************************************************/
+
+#ifndef __PICODEVICEDEFINITIONSEXPERIMENTAL_H__
+#define __PICODEVICEDEFINITIONSEXPERIMENTAL_H__
+
+#include <stdint.h>
+
+/// <summary>
+/// Probe user action (only button press events supported for now). Other event types
+/// may be added in future to support new probes.
+/// </summary>
+typedef enum enPicoProbeUserAction
+{
+  PICO_PROBE_BUTTON_PRESS, /// parameter struct -> PICO_PROBE_BUTTON_PRESS_PARAMETER
+} PICO_PROBE_USER_ACTION;
+
+/// <summary>
+/// The duration of the button press event.
+/// </summary>
+typedef enum enPicoProbeButtonPressType
+{
+  PICO_PROBE_BUTTON_SHORT_DURATION_PRESS,
+  PICO_PROBE_BUTTON_LONG_DURATION_PRESS,
+} PICO_PROBE_BUTTON_PRESS_TYPE;
+
+#pragma pack(push, 1)
+/// <summary>
+/// The parameter struct for a button press event, indicating which button was
+/// pressed (in case future probes have multiple) and the type of press.
+/// </summary>
+typedef struct tPicoProbeButtonPressParameter
+{
+  uint8_t buttonIndex;
+  PICO_PROBE_BUTTON_PRESS_TYPE buttonPressType;
+} PICO_PROBE_BUTTON_PRESS_PARAMETER;
+#pragma pack(pop)
+
+#endif

+ 356 - 0
pico-tcp-service/pico-tcp/inc/PicoDeviceEnums.h

@@ -0,0 +1,356 @@
+/****************************************************************************
+ *
+ * Filename:    PicoDeviceEnums.h
+ * Copyright:   Pico Technology Limited 2016 - 2022
+ * Description:
+ *
+ * This header contains definitions of enumerated types that describe
+ * various operating modes, trigger types, bandwidth limiters, etc.
+ *
+ ****************************************************************************/
+
+#ifndef __PICODEVICEENUMS_H__
+#define __PICODEVICEENUMS_H__
+
+typedef enum enPicoRatioMode
+{
+  PICO_RATIO_MODE_AGGREGATE = 1,
+  PICO_RATIO_MODE_DECIMATE = 2,
+  PICO_RATIO_MODE_AVERAGE = 4,
+  PICO_RATIO_MODE_DISTRIBUTION = 8,
+  PICO_RATIO_MODE_SUM = 16,
+
+  PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION = 0x10000000, // buffers cannot be set for this mode
+  PICO_RATIO_MODE_SEGMENT_HEADER = 0x20000000, // buffers do not need to be set for this
+  PICO_RATIO_MODE_TRIGGER = 0x40000000, // this cannot be combined with any other ratio mode
+  PICO_RATIO_MODE_RAW = 0x80000000
+} PICO_RATIO_MODE;
+
+typedef enum enPicoChannel
+{
+  PICO_CHANNEL_A = 0,
+  PICO_CHANNEL_B = 1,
+  PICO_CHANNEL_C = 2,
+  PICO_CHANNEL_D = 3,
+  PICO_CHANNEL_E = 4,
+  PICO_CHANNEL_F = 5,
+  PICO_CHANNEL_G = 6,
+  PICO_CHANNEL_H = 7,
+
+  PICO_PORT0 = 128,
+  PICO_PORT1 = 129,
+  PICO_PORT2 = 130,
+  PICO_PORT3 = 131,
+
+  PICO_EXTERNAL = 1000,
+  PICO_TRIGGER_AUX = 1001,
+
+  PICO_PULSE_WIDTH_SOURCE = 0x10000000,
+  PICO_DIGITAL_SOURCE = 0x10000001
+} PICO_CHANNEL;
+
+typedef enum enPicoChannelFlags
+{
+  PICO_CHANNEL_A_FLAGS = 1,
+  PICO_CHANNEL_B_FLAGS = 2,
+  PICO_CHANNEL_C_FLAGS = 4,
+  PICO_CHANNEL_D_FLAGS = 8,
+  PICO_CHANNEL_E_FLAGS = 16,
+  PICO_CHANNEL_F_FLAGS = 32,
+  PICO_CHANNEL_G_FLAGS = 64,
+  PICO_CHANNEL_H_FLAGS = 128,
+
+  PICO_PORT0_FLAGS = 65536,
+  PICO_PORT1_FLAGS = 131072,
+  PICO_PORT2_FLAGS = 262144,
+  PICO_PORT3_FLAGS = 524288,
+
+} PICO_CHANNEL_FLAGS;
+
+typedef enum enPicoPortDigitalChannel
+{
+  PICO_PORT_DIGITAL_CHANNEL0,
+  PICO_PORT_DIGITAL_CHANNEL1,
+  PICO_PORT_DIGITAL_CHANNEL2,
+  PICO_PORT_DIGITAL_CHANNEL3,
+  PICO_PORT_DIGITAL_CHANNEL4,
+  PICO_PORT_DIGITAL_CHANNEL5,
+  PICO_PORT_DIGITAL_CHANNEL6,
+  PICO_PORT_DIGITAL_CHANNEL7
+} PICO_PORT_DIGITAL_CHANNEL;
+
+typedef enum enPicoDataType
+{
+  PICO_INT8_T,
+  PICO_INT16_T,
+  PICO_INT32_T,
+  PICO_UINT32_T,
+  PICO_INT64_T
+} PICO_DATA_TYPE;
+
+typedef enum enPicoCoupling
+{
+  PICO_AC = 0,
+  PICO_DC = 1,
+
+  PICO_DC_50OHM = 50
+} PICO_COUPLING;
+
+typedef enum enPicoBandwidthLimiterFlags
+{
+  PICO_BW_FULL_FLAG = (1 << 0),
+  PICO_BW_20KHZ_FLAG = (1 << 1),
+  PICO_BW_100KHZ_FLAG = (1 << 2), //( default when current clamp detected: can be changed)
+  PICO_BW_1MHZ_FLAG = (1 << 3), //( default for 14 bits: can be changed)
+  PICO_BW_20MHZ_FLAG = (1 << 4),
+  PICO_BW_200MHZ_FLAG = (1 << 5),
+} PICO_BANDWIDTH_LIMITER_FLAGS;
+
+typedef enum enPicoBandwidthLimiter
+{
+  PICO_BW_FULL = 0,
+
+  PICO_BW_100KHZ = 100000,
+
+  PICO_BW_20KHZ = 20000,
+
+  PICO_BW_1MHZ = 1000000,
+  PICO_BW_20MHZ = 20000000,
+
+  PICO_BW_25MHZ = 25000000,
+
+  PICO_BW_50MHZ = 50000000,
+
+  PICO_BW_200MHZ = 200000000,
+  PICO_BW_250MHZ = 250000000,
+
+  PICO_BW_500MHZ = 500000000,
+
+} PICO_BANDWIDTH_LIMITER;
+
+typedef enum enPicoPulseWidthType
+{
+  PICO_PW_TYPE_NONE = 0,
+  PICO_PW_TYPE_LESS_THAN = 1,
+  PICO_PW_TYPE_GREATER_THAN = 2,
+  PICO_PW_TYPE_IN_RANGE = 3,
+  PICO_PW_TYPE_OUT_OF_RANGE = 4
+} PICO_PULSE_WIDTH_TYPE;
+
+typedef enum enPicoSweepType
+{
+  PICO_UP = 0,
+  PICO_DOWN = 1,
+  PICO_UPDOWN = 2,
+  PICO_DOWNUP = 3,
+} PICO_SWEEP_TYPE;
+
+typedef enum enPicoWaveType
+{
+  PICO_SINE = 0x00000011,
+  PICO_SQUARE = 0x00000012,
+  PICO_TRIANGLE = 0x00000013,
+  PICO_RAMP_UP = 0x00000014,
+  PICO_RAMP_DOWN = 0x00000015,
+  PICO_SINC = 0x00000016,
+  PICO_GAUSSIAN = 0x00000017,
+  PICO_HALF_SINE = 0x00000018,
+
+  PICO_DC_VOLTAGE = 0x00000400,
+
+  PICO_PWM = 0x00001000,
+
+  PICO_WHITENOISE = 0x00002001,
+  PICO_PRBS = 0x00002002, // Pseudo-Random Bit Stream
+
+  PICO_ARBITRARY = 0x10000000
+} PICO_WAVE_TYPE;
+
+typedef enum enPicoSigGenTrigType
+{
+  PICO_SIGGEN_RISING = 0,
+  PICO_SIGGEN_FALLING = 1,
+  PICO_SIGGEN_GATE_HIGH = 2,
+  PICO_SIGGEN_GATE_LOW = 3
+} PICO_SIGGEN_TRIG_TYPE;
+
+typedef enum enPicoSigGenTrigSource
+{
+  PICO_SIGGEN_NONE = 0,
+  PICO_SIGGEN_SCOPE_TRIG = 1,
+  PICO_SIGGEN_AUX_IN = 2,
+  PICO_SIGGEN_EXT_IN = 3,
+  PICO_SIGGEN_SOFT_TRIG = 4,
+  PICO_SIGGEN_TRIGGER_RAW = 5
+} PICO_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPicoSigGenFilterState
+{
+  PICO_SIGGEN_FILTER_AUTO = 0,
+  PICO_SIGGEN_FILTER_OFF = 1,
+  PICO_SIGGEN_FILTER_ON = 2
+} PICO_SIGGEN_FILTER_STATE;
+
+typedef enum enPicoSigGenParameter
+{
+  PICO_SIGGEN_PARAM_OUTPUT_VOLTS = 0,
+  PICO_SIGGEN_PARAM_SAMPLE = 1,
+  PICO_SIGGEN_PARAM_BUFFER_LENGTH = 2
+} PICO_SIGGEN_PARAMETER;
+
+typedef enum enPicoTimeUnits
+{
+  PICO_FS = 0,
+  PICO_PS = 1,
+  PICO_NS = 2,
+  PICO_US = 3,
+  PICO_MS = 4,
+  PICO_S = 5,
+} PICO_TIME_UNITS;
+
+typedef enum enPicoThresholdDirection
+{
+  PICO_ABOVE = 0, //using upper threshold
+  PICO_BELOW = 1, //using upper threshold
+  PICO_RISING = 2, // using upper threshold
+  PICO_FALLING = 3, // using upper threshold
+  PICO_RISING_OR_FALLING = 4, // using both thresholds
+  PICO_ABOVE_LOWER = 5, // using lower threshold
+  PICO_BELOW_LOWER = 6, // using lower threshold
+  PICO_RISING_LOWER = 7, // using lower threshold
+  PICO_FALLING_LOWER = 8, // using lower threshold
+
+  // Windowing using both thresholds
+  PICO_INSIDE = PICO_ABOVE,
+  PICO_OUTSIDE = PICO_BELOW,
+  PICO_ENTER = PICO_RISING,
+  PICO_EXIT = PICO_FALLING,
+  PICO_ENTER_OR_EXIT = PICO_RISING_OR_FALLING,
+  PICO_POSITIVE_RUNT = 9,
+  PICO_NEGATIVE_RUNT,
+
+  // no trigger set
+  PICO_NONE = PICO_RISING
+} PICO_THRESHOLD_DIRECTION;
+
+typedef enum enPicoThresholdMode
+{
+  PICO_LEVEL = 0,
+  PICO_WINDOW = 1
+} PICO_THRESHOLD_MODE;
+
+typedef enum enPicoEtsMode
+{
+  PICO_ETS_OFF = 0, // ETS disabled
+  PICO_ETS_FAST = 1, // Return ready as soon as requested no of interleaves is available
+  PICO_ETS_SLOW = 2, // Return ready every time a new set of no_of_cycles is collected
+} PICO_ETS_MODE;
+
+typedef enum enPicoIndexMode
+{
+  PICO_SINGLE = 0,
+  PICO_DUAL = 1,
+  PICO_QUAD = 2,
+} PICO_INDEX_MODE;
+
+typedef enum enPicoAction
+{
+  PICO_CLEAR_ALL = 0x00000001,
+  PICO_ADD = 0x00000002,
+
+  PICO_CLEAR_THIS_DATA_BUFFER = 0x00001000,
+  PICO_CLEAR_WAVEFORM_DATA_BUFFERS = 0x00002000,
+  PICO_CLEAR_WAVEFORM_READ_DATA_BUFFERS = 0x00004000,
+
+} PICO_ACTION;
+
+typedef enum enPicoTriggerState
+{
+  PICO_CONDITION_DONT_CARE = 0,
+  PICO_CONDITION_TRUE = 1,
+  PICO_CONDITION_FALSE = 2,
+} PICO_TRIGGER_STATE;
+
+typedef enum enPicoDeviceResolution
+{
+  PICO_DR_8BIT = 0,
+  PICO_DR_12BIT = 1,
+  PICO_DR_14BIT = 2,
+  PICO_DR_15BIT = 3,
+  PICO_DR_16BIT = 4,
+
+  PICO_DR_10BIT = 10,
+
+} PICO_DEVICE_RESOLUTION;
+
+typedef enum enPicoReadSelection
+{
+  PICO_READSELECTION_NONE = 0,
+  PICO_TRIGGER_READ = 1,
+  PICO_DATA_READ1 = 2,
+  PICO_DATA_READ2 = 3,
+  PICO_DATA_READ3 = 4,
+} PICO_READ_SELECTION;
+
+typedef enum enPicoTrimAction
+{
+  PICO_OLDEST,
+  PICO_RECENT
+} PICO_TRIM_ACTION;
+
+typedef enum enPicoDigitalPortHysteresis
+{
+  PICO_VERY_HIGH_400MV,
+  PICO_HIGH_200MV,
+  PICO_NORMAL_100MV,
+  PICO_LOW_50MV
+} PICO_DIGITAL_PORT_HYSTERESIS;
+
+typedef enum enPicoDigitalDirection
+{
+  PICO_DIGITAL_DONT_CARE,
+  PICO_DIGITAL_DIRECTION_LOW,
+  PICO_DIGITAL_DIRECTION_HIGH,
+  PICO_DIGITAL_DIRECTION_RISING,
+  PICO_DIGITAL_DIRECTION_FALLING,
+  PICO_DIGITAL_DIRECTION_RISING_OR_FALLING,
+  PICO_DIGITAL_MAX_DIRECTION
+} PICO_DIGITAL_DIRECTION;
+
+typedef enum enPicoConditionsInfo
+{
+  PICO_CLEAR_CONDITIONS = 0x00000001,
+  PICO_ADD_CONDITION = 0x00000002
+} PICO_CONDITIONS_INFO;
+
+typedef enum enPicoClockReference
+{
+  PICO_INTERNAL_REF,
+  PICO_EXTERNAL_REF
+} PICO_CLOCK_REFERENCE;
+
+typedef enum enPicoTriggerWithinPreTrigger
+{
+  PICO_DISABLE,
+  PICO_ARM
+} PICO_TRIGGER_WITHIN_PRE_TRIGGER;
+
+typedef enum tPicoTemperatureReference
+{
+  PICO_TEMPERATURE_UNINITIALISED,
+  PICO_TEMPERATURE_NORMAL,
+  PICO_TEMPERATURE_WARNING,
+  PICO_TEMPERATURE_CRITICAL
+} PICO_TEMPERATURE_REFERENCE;
+
+typedef enum enPicoDigitalPort
+{
+  PICO_DIGITAL_PORT_NONE = 0,
+
+  PICO_DIGITAL_PORT_MSO_POD = 1000,
+
+  PICO_DIGITAL_PORT_UNKNOWN_DEVICE = -2,
+
+} PICO_DIGITAL_PORT;
+
+#endif

+ 164 - 0
pico-tcp-service/pico-tcp/inc/PicoDeviceStructs.h

@@ -0,0 +1,164 @@
+/****************************************************************************
+ *
+ * Filename:    PicoDeviceStructs.h
+ * Copyright:   Pico Technology Limited 2016 - 2022
+ * Description:
+ *
+ * This header defines structs used by various Picoscope driver API calls,
+ * defining how to pack/unpack bytes to communicate with a connected scope.
+ *
+ ****************************************************************************/
+
+#ifndef __PICODEVICESTRUCTS_H__
+#define __PICODEVICESTRUCTS_H__
+
+#define DIGITAL_PORT_SERIAL_LENGTH 10
+#define DIGITAL_PORT_CALIBRATION_DATE_LENGTH 8
+
+#include <stdint.h>
+
+#include "PicoConnectProbes.h"
+#include "PicoDeviceEnums.h"
+#include "PicoStatus.h"
+
+#pragma pack(push,1)
+typedef struct tPicoTriggerInfo
+{
+	PICO_STATUS	status;
+	uint64_t	segmentIndex;
+	uint64_t	triggerIndex;
+	double		triggerTime;
+	PICO_TIME_UNITS	timeUnits;
+	uint64_t	missedTriggers;
+	uint64_t	timeStampCounter;
+} PICO_TRIGGER_INFO;
+
+typedef struct tPicoTriggerChannelProperties
+{
+	int16_t								thresholdUpper;
+	uint16_t							thresholdUpperHysteresis;
+	int16_t								thresholdLower;
+	uint16_t							thresholdLowerHysteresis;
+	PICO_CHANNEL					channel;
+} PICO_TRIGGER_CHANNEL_PROPERTIES;
+
+typedef struct tPicoCondition
+{
+	PICO_CHANNEL   		source;
+	PICO_TRIGGER_STATE condition;
+} PICO_CONDITION;
+
+typedef struct tPicoDirection
+{
+	PICO_CHANNEL							channel;
+	PICO_THRESHOLD_DIRECTION	direction;
+	PICO_THRESHOLD_MODE				thresholdMode;
+} PICO_DIRECTION;
+
+typedef struct tPicoUserProbeInteractions
+{
+	uint16_t connected_;
+
+	PICO_CHANNEL channel_;
+	uint16_t enabled_;
+
+	PicoConnectProbe probeName_;
+
+	uint8_t requiresPower_;
+	uint8_t isPowered_;
+
+	PICO_STATUS status_;
+
+	PICO_CONNECT_PROBE_RANGE probeOff_;
+
+	PICO_CONNECT_PROBE_RANGE rangeFirst_;
+	PICO_CONNECT_PROBE_RANGE rangeLast_;
+	PICO_CONNECT_PROBE_RANGE rangeCurrent_;
+
+	PICO_COUPLING couplingFirst_;
+	PICO_COUPLING couplingLast_;
+	PICO_COUPLING couplingCurrent_;
+
+  PICO_BANDWIDTH_LIMITER_FLAGS filterFlags_;
+  PICO_BANDWIDTH_LIMITER_FLAGS filterCurrent_;
+	PICO_BANDWIDTH_LIMITER defaultFilter_;
+} PICO_USER_PROBE_INTERACTIONS;
+
+typedef struct tPicoDataBuffers
+{
+	PICO_CHANNEL							channel_;
+	uint64_t									waveform_;
+	PICO_RATIO_MODE						downSampleRatioMode_;
+	PICO_READ_SELECTION				read_;
+
+	PICO_POINTER							bufferMax_;
+	PICO_POINTER							bufferMin_;
+	PICO_DATA_TYPE						dataType_;
+
+	uint32_t									nDistributionPoints_;
+} PICO_DATA_BUFFERS;
+
+typedef struct tPicoStreamingDataInfo
+{
+	// in
+	PICO_CHANNEL channel_;
+	PICO_RATIO_MODE mode_;
+	PICO_DATA_TYPE type_;
+
+	int32_t		noOfSamples_;
+	uint64_t	bufferIndex_;
+	int32_t	startIndex_;
+	int16_t   overflow_;
+} PICO_STREAMING_DATA_INFO;
+
+typedef struct tPicoStreamingDataTriggerInfo
+{
+	uint64_t	triggerAt_;
+	int16_t   triggered_;
+	int16_t		autoStop_;
+} PICO_STREAMING_DATA_TRIGGER_INFO;
+
+typedef struct tPicoScalingFactors
+{
+	PICO_CHANNEL							channel;
+	PICO_CONNECT_PROBE_RANGE  range;
+	int16_t										offset;
+	double							      scalingFactor;
+} PICO_SCALING_FACTORS_VALUES;
+
+typedef struct tProbeApp
+{
+	int32_t                   id_;
+	int32_t                   appMajorVersion_;
+	int32_t                   appMinorVersion_;
+} PROBE_APP;
+
+typedef struct tDigitalChannelDirections
+{
+  PICO_PORT_DIGITAL_CHANNEL channel;
+	PICO_DIGITAL_DIRECTION direction;
+} PICO_DIGITAL_CHANNEL_DIRECTIONS;
+
+typedef struct tPicoDigitalPortInteractions
+{
+  uint16_t connected_;
+
+  PICO_CHANNEL channel_;
+
+  PICO_DIGITAL_PORT digitalPortName_;
+
+  PICO_STATUS status_;
+
+  int8_t serial_[DIGITAL_PORT_SERIAL_LENGTH];
+  int8_t calibrationDate_[DIGITAL_PORT_CALIBRATION_DATE_LENGTH];
+} PICO_DIGITAL_PORT_INTERACTIONS;
+
+typedef struct tPicoChannelOvervoltageTripped
+{
+  PICO_CHANNEL channel_;
+  uint8_t tripped_;
+} PICO_CHANNEL_OVERVOLTAGE_TRIPPED;
+
+#pragma pack(pop)
+
+#endif

+ 1316 - 0
pico-tcp-service/pico-tcp/inc/PicoStatus.h

@@ -0,0 +1,1316 @@
+/**************************************************************************
+*
+* Filename:    PicoStatus.h
+* Copyright:   Pico Technology Limited 2002 - 2022
+* Description:
+*
+* This header files defines the status codes returned by a
+*	Pico device, a PC Oscilloscope or Data Logger.
+*
+* In comments, "<API>" is a placeholder for the name of the scope or
+* data logger API. For example, for the ps5000a API, it stands for
+* "PS5000A" or "ps5000a".
+*
+*************************************************************************/
+#ifndef __PICOSTATUS_H__
+#define __PICOSTATUS_H__
+
+#include <stdint.h>
+
+typedef void * PICO_POINTER;
+
+#define	PICO_DRIVER_VERSION                         0x00000000UL
+#define	PICO_USB_VERSION                            0x00000001UL
+#define	PICO_HARDWARE_VERSION                       0x00000002UL
+#define	PICO_VARIANT_INFO                           0x00000003UL
+#define	PICO_BATCH_AND_SERIAL                       0x00000004UL
+#define	PICO_CAL_DATE                               0x00000005UL
+#define	PICO_KERNEL_VERSION                         0x00000006UL
+
+#define PICO_DIGITAL_HARDWARE_VERSION               0x00000007UL
+#define PICO_ANALOGUE_HARDWARE_VERSION              0x00000008UL
+
+#define PICO_FIRMWARE_VERSION_1                     0x00000009UL
+#define PICO_FIRMWARE_VERSION_2                     0x0000000AUL
+
+#define PICO_MAC_ADDRESS                            0x0000000BUL
+
+#define PICO_SHADOW_CAL                             0x0000000CUL
+
+#define PICO_IPP_VERSION                            0x0000000DUL
+
+#define PICO_DRIVER_PATH                            0x0000000EUL
+
+#define PICO_FIRMWARE_VERSION_3                     0x0000000FUL
+
+#define PICO_FRONT_PANEL_FIRMWARE_VERSION           0x00000010UL
+
+#define PICO_BOOTLOADER_VERSION						0x10000001UL
+
+typedef uint32_t PICO_INFO;
+
+// The PicoScope is functioning correctly.
+#define PICO_OK                                     0x00000000UL
+
+// An attempt has been made to open more than <API>_MAX_UNITS.
+#define PICO_MAX_UNITS_OPENED                       0x00000001UL
+
+// Not enough memory could be allocated on the host machine.
+#define PICO_MEMORY_FAIL                            0x00000002UL
+
+// No Pico Technology device could be found.
+#define PICO_NOT_FOUND                              0x00000003UL
+
+// Unable to download firmware.
+#define PICO_FW_FAIL                                0x00000004UL
+
+// The driver is busy opening a device.
+#define PICO_OPEN_OPERATION_IN_PROGRESS             0x00000005UL
+
+// An unspecified failure occurred.
+#define PICO_OPERATION_FAILED                       0x00000006UL
+
+// The PicoScope is not responding to commands from the PC.
+#define PICO_NOT_RESPONDING                         0x00000007UL
+
+// The configuration information in the PicoScope is corrupt or missing.
+#define PICO_CONFIG_FAIL                            0x00000008UL
+
+// The picopp.sys file is too old to be used with the device driver.
+#define PICO_KERNEL_DRIVER_TOO_OLD                  0x00000009UL
+
+// The EEPROM has become corrupt, so the device will use a default setting.
+#define PICO_EEPROM_CORRUPT                         0x0000000AUL
+
+// The operating system on the PC is not supported by this driver.
+#define PICO_OS_NOT_SUPPORTED                       0x0000000BUL
+
+// There is no device with the handle value passed.
+#define PICO_INVALID_HANDLE                         0x0000000CUL
+
+// A parameter value is not valid.
+#define PICO_INVALID_PARAMETER                      0x0000000DUL
+
+// The timebase is not supported or is invalid.
+#define PICO_INVALID_TIMEBASE                       0x0000000EUL
+
+// The voltage range is not supported or is invalid.
+#define PICO_INVALID_VOLTAGE_RANGE                  0x0000000FUL
+
+// The channel number is not valid on this device or no channels have been set.
+#define PICO_INVALID_CHANNEL                        0x00000010UL
+
+// The channel set for a trigger is not available on this device.
+#define PICO_INVALID_TRIGGER_CHANNEL                0x00000011UL
+
+// The channel set for a condition is not available on this device.
+#define PICO_INVALID_CONDITION_CHANNEL              0x00000012UL
+
+// The device does not have a signal generator.
+#define PICO_NO_SIGNAL_GENERATOR                    0x00000013UL
+
+// Streaming has failed to start or has stopped without user request.
+#define PICO_STREAMING_FAILED                       0x00000014UL
+
+// Block failed to start - a parameter may have been set wrongly.
+#define PICO_BLOCK_MODE_FAILED                      0x00000015UL
+
+// A parameter that was required is NULL.
+#define PICO_NULL_PARAMETER                         0x00000016UL
+
+// The current functionality is not available while using ETS capture mode.
+#define PICO_ETS_MODE_SET                           0x00000017UL
+
+// No data is available from a run block call.
+#define PICO_DATA_NOT_AVAILABLE                     0x00000018UL
+
+// The buffer passed for the information was too small.
+#define PICO_STRING_BUFFER_TO_SMALL                 0x00000019UL
+
+// ETS is not supported on this device.
+#define PICO_ETS_NOT_SUPPORTED                      0x0000001AUL
+
+// The auto trigger time is less than the time it will take to collect the pre-trigger data.
+#define PICO_AUTO_TRIGGER_TIME_TO_SHORT             0x0000001BUL
+
+// The collection of data has stalled as unread data would be overwritten.
+#define PICO_BUFFER_STALL                           0x0000001CUL
+
+// Number of samples requested is more than available in the current memory segment.
+#define PICO_TOO_MANY_SAMPLES                       0x0000001DUL
+
+// Not possible to create number of segments requested.
+#define PICO_TOO_MANY_SEGMENTS                      0x0000001EUL
+
+// A null pointer has been passed in the trigger function or one of the parameters is out of range.
+#define PICO_PULSE_WIDTH_QUALIFIER                  0x0000001FUL
+
+// One or more of the hold-off parameters are out of range.
+#define PICO_DELAY                                  0x00000020UL
+
+// One or more of the source details are incorrect.
+#define	PICO_SOURCE_DETAILS                         0x00000021UL
+
+// One or more of the conditions are incorrect.
+#define PICO_CONDITIONS                             0x00000022UL
+
+// The driver's thread is currently in the <API>Ready callback
+// function and therefore the action cannot be carried out.
+#define	PICO_USER_CALLBACK                          0x00000023UL
+
+// An attempt is being made to get stored data while streaming.
+// Either stop streaming by calling <API>Stop, or use <API>GetStreamingLatestValues.
+#define PICO_DEVICE_SAMPLING                        0x00000024UL
+
+// Data is unavailable because a run has not been completed.
+#define PICO_NO_SAMPLES_AVAILABLE                   0x00000025UL
+
+// The memory segment index is out of range.
+#define PICO_SEGMENT_OUT_OF_RANGE                   0x00000026UL
+
+// The device is busy so data cannot be returned yet.
+#define PICO_BUSY                                   0x00000027UL
+
+// The start time to get stored data is out of range.
+#define PICO_STARTINDEX_INVALID                     0x00000028UL
+
+// The information number requested is not a valid number.
+#define PICO_INVALID_INFO                           0x00000029UL
+
+// The handle is invalid so no information is available about the device.
+// Only PICO_DRIVER_VERSION is available.
+#define PICO_INFO_UNAVAILABLE                       0x0000002AUL
+
+// The sample interval selected for streaming is out of range.
+#define PICO_INVALID_SAMPLE_INTERVAL                0x0000002BUL
+
+// ETS is set but no trigger has been set. A trigger setting is required for ETS.
+#define PICO_TRIGGER_ERROR                          0x0000002CUL
+
+// Driver cannot allocate memory.
+#define PICO_MEMORY                                 0x0000002DUL
+
+// Incorrect parameter passed to the signal generator.
+#define PICO_SIG_GEN_PARAM                          0x0000002EUL
+
+// Conflict between the shots and sweeps parameters sent to the signal generator.
+#define PICO_SHOTS_SWEEPS_WARNING                   0x0000002FUL
+
+// A software trigger has been sent but the trigger source is not a software trigger.
+#define PICO_SIGGEN_TRIGGER_SOURCE                  0x00000030UL
+
+// An <API>SetTrigger call has found a conflict between the trigger source and the AUX output enable.
+#define PICO_AUX_OUTPUT_CONFLICT                    0x00000031UL
+
+// ETS mode is being used and AUX is set as an input.
+#define PICO_AUX_OUTPUT_ETS_CONFLICT                0x00000032UL
+
+// Attempt to set different EXT input thresholds set for signal generator and oscilloscope trigger.
+#define PICO_WARNING_EXT_THRESHOLD_CONFLICT         0x00000033UL
+
+// An <API>SetTrigger... function has set AUX as an output and the signal generator is using it as a trigger.
+#define PICO_WARNING_AUX_OUTPUT_CONFLICT            0x00000034UL
+
+// The combined peak-to-peak voltage and the analog offset voltage exceed the maximum voltage the signal generator can produce.
+#define PICO_SIGGEN_OUTPUT_OVER_VOLTAGE             0x00000035UL
+
+// NULL pointer passed as delay parameter.
+#define PICO_DELAY_NULL                             0x00000036UL
+
+// The buffers for overview data have not been set while streaming.
+#define PICO_INVALID_BUFFER                         0x00000037UL
+
+// The analog offset voltage is out of range.
+#define PICO_SIGGEN_OFFSET_VOLTAGE                  0x00000038UL
+
+// The analog peak-to-peak voltage is out of range.
+#define PICO_SIGGEN_PK_TO_PK                        0x00000039UL
+
+// A block collection has been cancelled.
+#define PICO_CANCELLED                              0x0000003AUL
+
+// The segment index is not currently being used.
+#define PICO_SEGMENT_NOT_USED                       0x0000003BUL
+
+// The wrong GetValues function has been called for the collection mode in use.
+#define PICO_INVALID_CALL                           0x0000003CUL
+
+#define PICO_GET_VALUES_INTERRUPTED                 0x0000003DUL
+
+// The function is not available.
+#define PICO_NOT_USED                               0x0000003FUL
+
+// The aggregation ratio requested is out of range.
+#define PICO_INVALID_SAMPLERATIO                    0x00000040UL
+
+// Device is in an invalid state.
+#define PICO_INVALID_STATE                          0x00000041UL
+
+// The number of segments allocated is fewer than the number of captures requested.
+#define PICO_NOT_ENOUGH_SEGMENTS                    0x00000042UL
+
+// A driver function has already been called and not yet finished.
+// Only one call to the driver can be made at any one time.
+#define PICO_DRIVER_FUNCTION                        0x00000043UL
+
+// Not used.
+#define PICO_RESERVED                               0x00000044UL
+
+// An invalid coupling type was specified in <API>SetChannel.
+#define PICO_INVALID_COUPLING                       0x00000045UL
+
+// An attempt was made to get data before a data buffer was defined.
+#define PICO_BUFFERS_NOT_SET                        0x00000046UL
+
+// The selected downsampling mode (used for data reduction) is not allowed.
+#define PICO_RATIO_MODE_NOT_SUPPORTED               0x00000047UL
+
+// Aggregation was requested in rapid block mode.
+#define PICO_RAPID_NOT_SUPPORT_AGGREGATION          0x00000048UL
+
+// An invalid parameter was passed to <API>SetTriggerChannelProperties(V2).
+#define PICO_INVALID_TRIGGER_PROPERTY               0x00000049UL
+
+// The driver was unable to contact the oscilloscope.
+#define PICO_INTERFACE_NOT_CONNECTED                0x0000004AUL
+
+// Resistance-measuring mode is not allowed in conjunction with the specified probe.
+#define PICO_RESISTANCE_AND_PROBE_NOT_ALLOWED       0x0000004BUL
+
+// The device was unexpectedly powered down.
+#define PICO_POWER_FAILED                           0x0000004CUL
+
+// A problem occurred in <API>SetSigGenBuiltIn or <API>SetSigGenArbitrary.
+#define PICO_SIGGEN_WAVEFORM_SETUP_FAILED           0x0000004DUL
+
+// FPGA not successfully set up.
+#define PICO_FPGA_FAIL                              0x0000004EUL
+
+#define PICO_POWER_MANAGER                          0x0000004FUL
+
+// An impossible analog offset value was specified in <API>SetChannel.
+#define PICO_INVALID_ANALOGUE_OFFSET                0x00000050UL
+
+// There is an error within the device hardware.
+#define PICO_PLL_LOCK_FAILED                        0x00000051UL
+
+// There is an error within the device hardware.
+#define PICO_ANALOG_BOARD                           0x00000052UL
+
+// Unable to configure the signal generator.
+#define PICO_CONFIG_FAIL_AWG                        0x00000053UL
+
+// The FPGA cannot be initialized, so unit cannot be opened.
+#define PICO_INITIALISE_FPGA                        0x00000054UL
+
+// The frequency for the external clock is not within 15% of the nominal value.
+#define PICO_EXTERNAL_FREQUENCY_INVALID             0x00000056UL
+
+// The FPGA could not lock the clock signal.
+#define PICO_CLOCK_CHANGE_ERROR                     0x00000057UL
+
+// You are trying to configure the AUX input as both a trigger and a reference clock.
+#define PICO_TRIGGER_AND_EXTERNAL_CLOCK_CLASH       0x00000058UL
+
+// You are trying to configure the AUX input as both a pulse width qualifier and a reference clock.
+#define PICO_PWQ_AND_EXTERNAL_CLOCK_CLASH           0x00000059UL
+
+// The requested scaling file cannot be opened.
+#define PICO_UNABLE_TO_OPEN_SCALING_FILE            0x0000005AUL
+
+// The frequency of the memory is reporting incorrectly.
+#define PICO_MEMORY_CLOCK_FREQUENCY                 0x0000005BUL
+
+// The I2C that is being actioned is not responding to requests.
+#define PICO_I2C_NOT_RESPONDING                     0x0000005CUL
+
+// There are no captures available and therefore no data can be returned.
+#define PICO_NO_CAPTURES_AVAILABLE                  0x0000005DUL
+
+// The number of trigger channels is greater than 4,
+// except for a PicoScope 4824 where 8 channels are allowed for rising/falling/rising_or_falling trigger directions.
+#define PICO_TOO_MANY_TRIGGER_CHANNELS_IN_USE				0x0000005FUL
+
+// If you have specified a trigger direction which is not allowed, for example specifying PICO_ABOVE
+// without another condition which crosses a threshold on another channel.
+#define PICO_INVALID_TRIGGER_DIRECTION							0x00000060UL
+
+// When more than 4 trigger channels are set and their trigger condition states are not <API>_CONDITION_TRUE.
+#define PICO_INVALID_TRIGGER_STATES									0x00000061UL
+
+// The capture mode the device is currently running in does not support the current request.
+#define PICO_NOT_USED_IN_THIS_CAPTURE_MODE          0x0000005EUL
+
+#define PICO_GET_DATA_ACTIVE                        0x00000103UL
+
+// Codes 104 to 10B are used by the PT104 (USB) when connected via the Network Socket.
+
+// The device is currently connected via the IP Network socket and thus the call made is not supported.
+#define PICO_IP_NETWORKED                           0x00000104UL
+
+// An incorrect IP address has been passed to the driver.
+#define PICO_INVALID_IP_ADDRESS                     0x00000105UL
+
+// The IP socket has failed.
+#define PICO_IPSOCKET_FAILED                        0x00000106UL
+
+// The IP socket has timed out.
+#define PICO_IPSOCKET_TIMEDOUT                      0x00000107UL
+
+// Failed to apply the requested settings.
+#define PICO_SETTINGS_FAILED                        0x00000108UL
+
+// The network connection has failed.
+#define PICO_NETWORK_FAILED                         0x00000109UL
+
+// Unable to load the WS2 DLL.
+#define PICO_WS2_32_DLL_NOT_LOADED                  0x0000010AUL
+
+// The specified IP port is invalid.
+#define PICO_INVALID_IP_PORT                        0x0000010BUL
+
+// The type of coupling requested is not supported on the opened device.
+#define PICO_COUPLING_NOT_SUPPORTED                 0x0000010CUL
+
+// Bandwidth limiting is not supported on the opened device.
+#define PICO_BANDWIDTH_NOT_SUPPORTED                0x0000010DUL
+
+// The value requested for the bandwidth limit is out of range.
+#define PICO_INVALID_BANDWIDTH                      0x0000010EUL
+
+// The arbitrary waveform generator is not supported by the opened device.
+#define PICO_AWG_NOT_SUPPORTED                      0x0000010FUL
+
+// Data has been requested with ETS mode set but run block has not been called,
+// or stop has been called.
+#define PICO_ETS_NOT_RUNNING                        0x00000110UL
+
+// White noise output is not supported on the opened device.
+#define PICO_SIG_GEN_WHITENOISE_NOT_SUPPORTED       0x00000111UL
+
+// The wave type requested is not supported by the opened device.
+#define PICO_SIG_GEN_WAVETYPE_NOT_SUPPORTED         0x00000112UL
+
+// The requested digital port number is out of range (MSOs only).
+#define PICO_INVALID_DIGITAL_PORT                   0x00000113UL
+
+// The digital channel is not in the range <API>_DIGITAL_CHANNEL0 to
+// <API>_DIGITAL_CHANNEL15, the digital channels that are supported.
+#define PICO_INVALID_DIGITAL_CHANNEL                0x00000114UL
+
+// The digital trigger direction is not a valid trigger direction and should be equal
+// in value to one of the <API>_DIGITAL_DIRECTION enumerations.
+#define PICO_INVALID_DIGITAL_TRIGGER_DIRECTION      0x00000115UL
+
+// Signal generator does not generate pseudo-random binary sequence.
+#define	PICO_SIG_GEN_PRBS_NOT_SUPPORTED             0x00000116UL
+
+// When a digital port is enabled, ETS sample mode is not available for use.
+#define PICO_ETS_NOT_AVAILABLE_WITH_LOGIC_CHANNELS  0x00000117UL
+
+// There has been no new sample taken, this value has already been returned previously.
+#define PICO_WARNING_REPEAT_VALUE                   0x00000118UL
+
+// The DC power supply is connected.
+#define PICO_POWER_SUPPLY_CONNECTED                 0x00000119UL
+
+// The DC power supply is not connected.
+// For many 4+ Channel devices this will mean a restricted feature set is offered e.g. for a 4 channel device - C and D are usually disabled.
+// Check the respective API programmers guide of your device for the full details.
+#define PICO_POWER_SUPPLY_NOT_CONNECTED             0x0000011AUL
+
+// Incorrect power mode passed for current power source.
+#define PICO_POWER_SUPPLY_REQUEST_INVALID           0x0000011BUL
+
+// The supply voltage from the USB source is too low.
+#define PICO_POWER_SUPPLY_UNDERVOLTAGE              0x0000011CUL
+
+// The oscilloscope is in the process of capturing data.
+#define PICO_CAPTURING_DATA                         0x0000011DUL
+
+// A USB 3.0 device is connected to a non-USB 3.0 port.
+#define PICO_USB3_0_DEVICE_NON_USB3_0_PORT          0x0000011EUL
+
+// A function has been called that is not supported by the current device.
+#define PICO_NOT_SUPPORTED_BY_THIS_DEVICE           0x0000011FUL
+
+// The device resolution is invalid (out of range).
+#define PICO_INVALID_DEVICE_RESOLUTION              0x00000120UL
+
+// The number of channels that can be enabled is limited in 15 and 16-bit modes.
+// (Flexible Resolution Oscilloscopes only)
+#define PICO_INVALID_NUMBER_CHANNELS_FOR_RESOLUTION 0x00000121UL
+
+// USB power not sufficient for all requested channels.
+#define PICO_CHANNEL_DISABLED_DUE_TO_USB_POWERED    0x00000122UL
+
+// The signal generator does not have a configurable DC offset.
+#define PICO_SIGGEN_DC_VOLTAGE_NOT_CONFIGURABLE     0x00000123UL
+
+// An attempt has been made to define pre-trigger delay without first enabling a trigger.
+#define PICO_NO_TRIGGER_ENABLED_FOR_TRIGGER_IN_PRE_TRIG  0x00000124UL
+
+// An attempt has been made to define pre-trigger delay without first arming a trigger.
+#define PICO_TRIGGER_WITHIN_PRE_TRIG_NOT_ARMED           0x00000125UL
+
+// Pre-trigger delay and post-trigger delay cannot be used at the same time.
+#define PICO_TRIGGER_WITHIN_PRE_NOT_ALLOWED_WITH_DELAY   0x00000126UL
+
+// The array index points to a nonexistent trigger.
+#define PICO_TRIGGER_INDEX_UNAVAILABLE                   0x00000127UL
+
+#define PICO_AWG_CLOCK_FREQUENCY									0x00000128UL
+
+// There are more than 4 analog channels with a trigger condition set.
+#define PICO_TOO_MANY_CHANNELS_IN_USE							0x00000129UL
+
+// The condition parameter is a null pointer.
+#define PICO_NULL_CONDITIONS											0x0000012AUL
+
+// There is more than one condition pertaining to the same channel.
+#define PICO_DUPLICATE_CONDITION_SOURCE						0x0000012BUL
+
+// The parameter relating to condition information is out of range.
+#define PICO_INVALID_CONDITION_INFO								0x0000012CUL
+
+// Reading the meta data has failed.
+#define PICO_SETTINGS_READ_FAILED									0x0000012DUL
+
+// Writing the meta data has failed.
+#define PICO_SETTINGS_WRITE_FAILED								0x0000012EUL
+
+// A parameter has a value out of the expected range.
+#define PICO_ARGUMENT_OUT_OF_RANGE								0x0000012FUL
+
+// The driver does not support the hardware variant connected.
+#define PICO_HARDWARE_VERSION_NOT_SUPPORTED				0x00000130UL
+
+// The driver does not support the digital hardware variant connected.
+#define PICO_DIGITAL_HARDWARE_VERSION_NOT_SUPPORTED				0x00000131UL
+
+// The driver does not support the analog hardware variant connected.
+#define PICO_ANALOGUE_HARDWARE_VERSION_NOT_SUPPORTED				0x00000132UL
+
+// Converting a channel's ADC value to resistance has failed.
+#define PICO_UNABLE_TO_CONVERT_TO_RESISTANCE			0x00000133UL
+
+// The channel is listed more than once in the function call.
+#define PICO_DUPLICATED_CHANNEL										0x00000134UL
+
+// The range cannot have resistance conversion applied.
+#define PICO_INVALID_RESISTANCE_CONVERSION				0x00000135UL
+
+// An invalid value is in the max buffer.
+#define PICO_INVALID_VALUE_IN_MAX_BUFFER					0x00000136UL
+
+// An invalid value is in the min buffer.
+#define PICO_INVALID_VALUE_IN_MIN_BUFFER					0x00000137UL
+
+// When calculating the frequency for phase conversion,
+// the frequency is greater than that supported by the current variant.
+#define PICO_SIGGEN_FREQUENCY_OUT_OF_RANGE				0x00000138UL
+
+// The device's EEPROM is corrupt. Contact Pico Technology support: https://www.picotech.com/tech-support.
+#define PICO_EEPROM2_CORRUPT											0x00000139UL
+
+// The EEPROM has failed.
+#define PICO_EEPROM2_FAIL													0x0000013AUL
+
+// The serial buffer is too small for the required information.
+#define PICO_SERIAL_BUFFER_TOO_SMALL							0x0000013BUL
+
+// The signal generator trigger and the external clock have both been set.
+// This is not allowed.
+#define PICO_SIGGEN_TRIGGER_AND_EXTERNAL_CLOCK_CLASH 0x0000013CUL
+
+// The AUX trigger was enabled and the external clock has been enabled,
+// so the AUX has been automatically disabled.
+#define PICO_WARNING_SIGGEN_AUXIO_TRIGGER_DISABLED 0x0000013DUL
+
+// The AUX I/O was set as a scope trigger and is now being set as a signal generator
+// gating trigger. This is not allowed.
+#define PICO_SIGGEN_GATING_AUXIO_NOT_AVAILABLE	 	 0x00000013EUL
+
+// The AUX I/O was set by the signal generator as a gating trigger and is now being set
+// as a scope trigger. This is not allowed.
+#define PICO_SIGGEN_GATING_AUXIO_ENABLED				 	 0x00000013FUL
+
+// A resource has failed to initialise.
+#define PICO_RESOURCE_ERROR												 0x00000140UL
+
+// The temperature type is out of range.
+#define PICO_TEMPERATURE_TYPE_INVALID							 0x000000141UL
+
+// A requested temperature type is not supported on this device.
+#define PICO_TEMPERATURE_TYPE_NOT_SUPPORTED				 0x000000142UL
+
+// A read/write to the device has timed out.
+#define PICO_TIMEOUT															 0x00000143UL
+
+// The device cannot be connected correctly.
+#define PICO_DEVICE_NOT_FUNCTIONING							   0x00000144UL
+
+// The driver has experienced an unknown error and is unable to recover from this error.
+#define PICO_INTERNAL_ERROR												 0x00000145UL
+
+// Used when opening units via IP and more than multiple units have the same IP address.
+#define PICO_MULTIPLE_DEVICES_FOUND								 0x00000146UL
+
+#define PICO_WARNING_NUMBER_OF_SEGMENTS_REDUCED 	 					0x00000147UL
+
+// The calibration pin states argument is out of range.
+#define PICO_CAL_PINS_STATES											0x00000148UL
+
+// The calibration pin frequency argument is out of range.
+#define PICO_CAL_PINS_FREQUENCY										0x00000149UL
+
+// The calibration pin amplitude argument is out of range.
+#define PICO_CAL_PINS_AMPLITUDE										0x0000014AUL
+
+// The calibration pin wavetype argument is out of range.
+#define PICO_CAL_PINS_WAVETYPE										0x0000014BUL
+
+// The calibration pin offset argument is out of range.
+#define PICO_CAL_PINS_OFFSET											0x0000014CUL
+
+// The probe's identity has a problem.
+#define PICO_PROBE_FAULT													0x0000014DUL
+
+// The probe has not been identified.
+#define PICO_PROBE_IDENTITY_UNKNOWN								0x0000014EUL
+
+// Enabling the probe would cause the device to exceed the allowable current limit.
+#define PICO_PROBE_POWER_DC_POWER_SUPPLY_REQUIRED 0x0000014FUL
+
+// The DC power supply is connected; enabling the probe would cause the device to exceed the
+// allowable current limit.
+#define PICO_PROBE_NOT_POWERED_WITH_DC_POWER_SUPPLY 0x00000150UL
+
+// Failed to complete probe configuration.
+#define	PICO_PROBE_CONFIG_FAILURE									0x00000151UL
+
+// Failed to set the callback function, as currently in current callback function.
+#define	PICO_PROBE_INTERACTION_CALLBACK						0x00000152UL
+
+// The probe has been verified but not known on this driver.
+#define	PICO_UNKNOWN_INTELLIGENT_PROBE						0x00000153UL
+
+// The intelligent probe cannot be verified.
+#define	PICO_INTELLIGENT_PROBE_CORRUPT						0x00000154UL
+
+// The callback is null, probe collection will only start when
+// first callback is a none null pointer.
+#define PICO_PROBE_COLLECTION_NOT_STARTED					0x00000155UL
+
+// The current drawn by the probe(s) has exceeded the allowed limit.
+#define PICO_PROBE_POWER_CONSUMPTION_EXCEEDED    0x00000156UL
+
+// The channel range limits have changed due to connecting or disconnecting a probe
+// the channel has been enabled.
+#define PICO_WARNING_PROBE_CHANNEL_OUT_OF_SYNC 0x00000157UL
+
+#define PICO_ENDPOINT_MISSING									 0x00000158UL
+#define PICO_UNKNOWN_ENDPOINT_REQUEST							 0x00000159UL
+
+// The ADC on board the device has not been correctly identified.
+#define PICO_ADC_TYPE_ERROR													0x0000015AUL
+
+#define PICO_FPGA2_FAILED														0x0000015BUL
+
+#define PICO_FPGA2_DEVICE_STATUS										0x0000015CUL
+
+#define PICO_ENABLE_PROGRAM_FPGA2_FAILED						0x0000015DUL
+#define PICO_NO_CHANNELS_OR_PORTS_ENABLED									0x0000015EUL
+
+#define PICO_INVALID_RATIO_MODE											0x0000015FUL
+
+#define PICO_READS_NOT_SUPPORTED_IN_CURRENT_CAPTURE_MODE 0x00000160UL
+
+// These selection tests can be masked together to show that mode than one read selection has failed the tests,
+// therefore theses error codes cover 0x00000161UL to 0x0000016FUL.
+#define PICO_TRIGGER_READ_SELECTION_CHECK_FAILED						0x00000161UL
+#define PICO_DATA_READ1_SELECTION_CHECK_FAILED						0x00000162UL
+#define PICO_DATA_READ2_SELECTION_CHECK_FAILED						0x00000164UL
+#define PICO_DATA_READ3_SELECTION_CHECK_FAILED						0x00000168UL
+
+// The requested read is not one of the reads available in enPicoReadSelection.
+#define PICO_READ_SELECTION_OUT_OF_RANGE						0x00000170UL
+
+// The downsample ratio options cannot be combined together for this request.
+#define PICO_MULTIPLE_RATIO_MODES										0x00000171UL
+
+// The enPicoReadSelection request has no samples available.
+#define PICO_NO_SAMPLES_READ			                  0x00000172UL
+
+// The enPicoReadSelection did not include one of the downsample ratios now requested.
+#define PICO_RATIO_MODE_NOT_REQUESTED								0x00000173UL
+
+// No read requests have been made.
+#define PICO_NO_USER_READ_REQUESTS_SET							0x00000174UL
+
+// The parameter for <number of values> cannot be zero.
+#define PICO_ZERO_SAMPLES_INVALID										0x00000175UL
+
+// The analog hardware cannot be identified; contact Pico Technology Technical Support.
+#define	PICO_ANALOGUE_HARDWARE_MISSING							0x00000176UL
+
+// Setting of the analog hardware pins failed.
+#define PICO_ANALOGUE_HARDWARE_PINS									0x00000177UL
+
+// An SMPS fault has occurred.
+#define PICO_ANALOGUE_HARDWARE_SMPS_FAULT						0x00000178UL
+
+// There appears to be a conflict between the expected and actual hardware in the device; contact Pico Technology Technical Support.
+#define PICO_DIGITAL_ANALOGUE_HARDWARE_CONFLICT			0x00000179UL
+
+// One or more of the enPicoRatioMode requested do not have a data buffer set.
+#define PICO_RATIO_MODE_BUFFER_NOT_SET							0x0000017AUL
+
+// The resolution is valid but not supported by the opened device.
+#define PICO_RESOLUTION_NOT_SUPPORTED_BY_VARIANT		0x0000017BUL
+
+// The requested trigger threshold is out of range for the current device resolution.
+#define PICO_THRESHOLD_OUT_OF_RANGE									0x0000017CUL
+
+// The simple trigger only supports upper edge direction options.
+#define PICO_INVALID_SIMPLE_TRIGGER_DIRECTION				0x0000017DUL
+
+// The aux trigger is not supported on this variant.
+#define PICO_AUX_NOT_SUPPORTED											0x0000017EUL
+
+// The trigger directions pointer may not be null.
+#define PICO_NULL_DIRECTIONS												0x0000017FUL
+
+// The trigger channel properties pointer may not be null.
+#define PICO_NULL_CHANNEL_PROPERTIES								0x00000180UL
+
+// A trigger is set on a channel that has not been enabled.
+#define PICO_TRIGGER_CHANNEL_NOT_ENABLED						0x00000181UL
+
+// A trigger condition has been set but a trigger property not set.
+#define PICO_CONDITION_HAS_NO_TRIGGER_PROPERTY			0x00000182UL
+
+// When requesting trigger data, this option can only be combined with the segment header ratio mode flag.
+#define PICO_RATIO_MODE_TRIGGER_MASKING_INVALID			0x00000183UL
+
+// The trigger data buffer must be 40 or more samples in size.
+#define PICO_TRIGGER_DATA_REQUIRES_MIN_BUFFER_SIZE_OF_40_SAMPLES 0x00000184UL
+
+// The number of requested waveforms is greater than the number of memory segments allocated.
+#define PICO_NO_OF_CAPTURES_OUT_OF_RANGE						0x00000185UL
+
+// When requesting segment header information, the segment header does not require a data buffer,
+// to get the segment information use GetTriggerInfo.
+#define PICO_RATIO_MODE_SEGMENT_HEADER_DOES_NOT_REQUIRE_BUFFERS	0x00000186UL
+
+// Use GetTriggerInfo to retrieve the segment header information.
+#define PICO_FOR_SEGMENT_HEADER_USE_GETTRIGGERINFO	0x00000187UL
+
+// A read request has not been set.
+#define PICO_READ_NOT_SET														0x00000188UL
+
+// The expected and actual states of the ADCs do not match.
+#define PICO_ADC_SETTING_MISMATCH										0x00000189UL
+
+// The requested data type is not one of the enPicoDataType listed.
+#define PICO_DATATYPE_INVALID												0x0000018AUL
+
+// The down sample ratio mode requested does not support the enPicoDataType option chosen.
+#define PICO_RATIO_MODE_DOES_NOT_SUPPORT_DATATYPE		0x0000018BUL
+
+// The channel combination is not valid for the resolution.
+#define PICO_CHANNEL_COMBINATION_NOT_VALID_IN_THIS_RESOLUTION 0x0000018CUL
+
+
+#define PICO_USE_8BIT_RESOLUTION										0x0000018DUL
+
+// The buffer for minimum data values and maximum data values are the same buffers.
+#define PICO_AGGREGATE_BUFFERS_SAME_POINTER					0x0000018EUL
+
+// The read request number of samples requested for an overlapped operation are more
+// than the total number of samples to capture.
+#define PICO_OVERLAPPED_READ_VALUES_OUT_OF_RANGE		0x0000018FUL
+
+// The overlapped read request has more segments specified than segments allocated.
+#define PICO_OVERLAPPED_READ_SEGMENTS_OUT_OF_RANGE	0x00000190UL
+
+// The number of channel combinations available are greater than the array size received.
+#define PICO_CHANNELFLAGSCOMBINATIONS_ARRAY_SIZE_TOO_SMALL 0x00000191UL
+
+// The number of captures is larger than the maximum number of segments allowed for the device variant.
+#define PICO_CAPTURES_EXCEEDS_NO_OF_SUPPORTED_SEGMENTS 0x00000192UL
+
+// The time unit requested is not one of the listed enPicoTimeUnits.
+#define PICO_TIME_UNITS_OUT_OF_RANGE								0x00000193UL
+
+// The number of samples parameter may not be zero.
+#define PICO_NO_SAMPLES_REQUESTED										0x00000194UL
+
+// The action requested is not listed in enPicoAction.
+#define PICO_INVALID_ACTION													0x00000195UL
+
+// When adding buffers for the same read request the buffers for all ratio mode requests have to be the same size.
+#define PICO_NO_OF_SAMPLES_NEED_TO_BE_EQUAL_WHEN_ADDING_BUFFERS 0x00000196UL
+
+// The data is being processed but there is no empty data buffers available, a new data buffer needs to be set sent to the driver
+// so that the data can be processed.
+#define PICO_WAITING_FOR_DATA_BUFFERS								0x00000197UL
+
+// when streaming data, only one read option is available.
+#define PICO_STREAMING_ONLY_SUPPORTS_ONE_READ				0x00000198UL
+
+// A clear read request is not one of the enPicoAction listed.
+#define PICO_CLEAR_DATA_BUFFER_INVALID					0x00000199UL
+
+// The combination of action flags are not allowed.
+#define PICO_INVALID_ACTION_FLAGS_COMBINATION				0x0000019AUL
+
+//  PICO_ADD request has been made but both data buffers are set to null and so there is nowhere to put the data.
+#define PICO_BOTH_MIN_AND_MAX_NULL_BUFFERS_CANNOT_BE_ADDED 0x0000019BUL
+
+// A conflict between the data buffers being set has occurred. Please use the PICO_CLEAR_ALL action to reset.
+#define PICO_CONFLICT_IN_SET_DATA_BUFFERS_CALL_REMOVE_DATA_BUFFER_TO_RESET 0x0000019CUL
+
+// While processing data, buffers cannot be removed from the data buffers list.
+#define PICO_REMOVING_DATA_BUFFER_ENTRIES_NOT_ALLOWED_WHILE_DATA_PROCESSING  0x0000019DUL
+
+//  An USB request has failed.
+#define PICO_CYUSB_REQUEST_FAILED						0x00000200UL
+
+// A request has been made to retrieve the latest streaming data, but with either a null pointer or an array size set to zero.
+#define PICO_STREAMING_DATA_REQUIRED				0x00000201UL
+
+// A buffer being set has a length that is invalid (ie less than zero).
+#define PICO_INVALID_NUMBER_OF_SAMPLES			0x00000202UL
+
+// The distribution size may not be zero.
+#define PICO_INVALID_DISTRIBUTION						0x00000203UL
+
+// The buffer length in bytes is greater than a 4-byte word.
+#define PICO_BUFFER_LENGTH_GREATER_THAN_INT32_T 0x00000204UL
+
+// The PLL has failed.
+#define PICO_PLL_MUX_OUT_FAILED             0x00000209UL
+
+// Pulse width only supports one direction.
+#define PICO_ONE_PULSE_WIDTH_DIRECTION_ALLOWED 0x0000020AUL
+
+// There is no external trigger available on the device specified by the handle.
+#define PICO_EXTERNAL_TRIGGER_NOT_SUPPORTED 0x0000020BUL
+
+// The condition parameter is a null pointer.
+#define PICO_NO_TRIGGER_CONDITIONS_SET							0x0000020CUL
+
+// The number of trigger channel properties it outside the allowed range (is less than zero).
+#define PICO_NO_OF_CHANNEL_TRIGGER_PROPERTIES_OUT_OF_RANGE 0x0000020DUL
+
+// A probe has been plugged into a channel, but can not be identified correctly.
+#define PICO_PROBE_COMPONENT_ERROR 0x0000020EUL
+
+// The probe is incompatible with the device channel it is connected to. This could lead to error in the measurements.
+#define PICO_INCOMPATIBLE_PROBE 0x0000020FUL
+
+// The requested channel for ETS triggering is not supported.
+#define PICO_INVALID_TRIGGER_CHANNEL_FOR_ETS              0x00000210UL
+
+// While the device is streaming the get values method is not available
+#define PICO_NOT_AVAILABLE_WHEN_STREAMING_IS_RUNNING 0x00000211UL
+
+// the requested state is not one of the enSharedTriggerWithinPreTrigger values
+#define PICO_INVALID_TRIGGER_WITHIN_PRE_TRIGGER_STATE 0x00000212UL
+
+// the number of captures have to be greater than zero
+#define PICO_ZERO_NUMBER_OF_CAPTURES_INVALID 0x00000213UL
+
+// the quantifier for a pointer, defining the length in bytes is invalid
+#define PICO_INVALID_LENGTH 0x00000214UL
+
+// the trigger delay is greater than supported by the hardware
+#define PICO_TRIGGER_DELAY_OUT_OF_RANGE 0x00000300UL
+
+// the requested threshold direction is not allowed with the specified channel
+#define PICO_INVALID_THRESHOLD_DIRECTION 0x00000301UL
+
+// the requested threshold mode is not allowed with the specified channel
+#define PICO_INVALID_THRESHOLD_MODE 0x00000302UL
+
+// The timebase is not supported or is invalid.
+#define PICO_TIMEBASE_NOT_SUPPORTED_BY_RESOLUTION 0x00000303UL
+
+// The device variant is not supported by this current driver.
+#define PICO_INVALID_VARIANT															0x00001000UL
+
+// The actual memory module does not match the expected memory module.
+#define PICO_MEMORY_MODULE_ERROR													0x00001001UL
+
+// A null pointer has been passed in the trigger function or one of the parameters is out of range.
+#define PICO_PULSE_WIDTH_QUALIFIER_LOWER_UPPER_CONFILCT  0x00002000UL
+
+// The pulse width qualifier type is not one of the listed options.
+#define PICO_PULSE_WIDTH_QUALIFIER_TYPE  0x00002001UL
+
+// The pulse width qualifier direction is not one of the listed options.
+#define PICO_PULSE_WIDTH_QUALIFIER_DIRECTION 0x00002002UL
+
+// The threshold range is not one of the listed options.
+#define PICO_THRESHOLD_MODE_OUT_OF_RANGE 0x00002003UL
+
+// The trigger direction and pulse width option conflict with each other.
+#define PICO_TRIGGER_AND_PULSEWIDTH_DIRECTION_IN_CONFLICT 0x00002004UL
+
+// The thresholds upper limits and thresholds lower limits conflict with each other.
+#define PICO_THRESHOLD_UPPER_LOWER_MISMATCH 0x00002005UL
+
+// The pulse width lower count is out of range.
+#define PICO_PULSE_WIDTH_LOWER_OUT_OF_RANGE	0x00002006UL
+
+// The pulse width upper count is out of range.
+#define PICO_PULSE_WIDTH_UPPER_OUT_OF_RANGE 0x00002007UL
+
+// The devices front panel has caused an error.
+#define PICO_FRONT_PANEL_ERROR 0x00002008UL
+
+// The actual and expected mode of the front panel do not match.
+#define PICO_FRONT_PANEL_MODE 0x0000200BUL
+
+// A front panel feature is not available or failed to configure.
+#define PICO_FRONT_PANEL_FEATURE 0x0000200CUL
+
+// When setting the pulse width conditions either the pointer is null or the number of conditions is set to zero.
+#define PICO_NO_PULSE_WIDTH_CONDITIONS_SET	0x0000200DUL
+
+// a trigger condition exists for a port, but the port has not been enabled
+#define PICO_TRIGGER_PORT_NOT_ENABLED 0x0000200EUL
+
+// a trigger condition exists for a port, but no digital channel directions have been set
+#define PICO_DIGITAL_DIRECTION_NOT_SET 0x0000200FUL
+
+#define PICO_I2C_DEVICE_INVALID_READ_COMMAND 0x00002010UL
+
+#define PICO_I2C_DEVICE_INVALID_RESPONSE 0x00002011UL
+
+#define PICO_I2C_DEVICE_INVALID_WRITE_COMMAND 0x00002012UL
+
+#define PICO_I2C_DEVICE_ARGUMENT_OUT_OF_RANGE 0x00002013UL
+
+// The actual and expected mode do not match.
+#define PICO_I2C_DEVICE_MODE 0x00002014UL
+
+// While trying to configure the device, set up failed.
+#define PICO_I2C_DEVICE_SETUP_FAILED 0x00002015UL
+
+// A feature is not available or failed to configure.
+#define PICO_I2C_DEVICE_FEATURE 0x00002016UL
+
+// The device did not pass the validation checks.
+#define PICO_I2C_DEVICE_VALIDATION_FAILED 0x00002017UL
+
+#define PICO_INTERNAL_HEADER_ERROR 0x00002018UL
+
+// The device couldn't write the channel settings due to a hardware fault
+#define PICO_FAILED_TO_WRITE_HARDWARE_FAULT 0x00002019UL
+
+// The number of MSO's edge transitions being set is not supported by this device (RISING, FALLING, or RISING_OR_FALLING).
+#define PICO_MSO_TOO_MANY_EDGE_TRANSITIONS_WHEN_USING_PULSE_WIDTH 0x00003000UL
+
+// A probe LED position requested is not one of the available probe positions in the ProbeLedPosition enum.
+#define PICO_INVALID_PROBE_LED_POSITION 0x00003001UL
+
+// The LED position is not supported by the selected variant.
+#define PICO_PROBE_LED_POSITION_NOT_SUPPORTED 0x00003002UL
+
+// A channel has more than one of the same LED position in the ProbeChannelLedSetting struct.
+#define PICO_DUPLICATE_PROBE_CHANNEL_LED_POSITION 0x00003003UL
+
+// Setting the probes LED has failed.
+#define PICO_PROBE_LED_FAILURE 0x00003004UL
+
+// Probe is not supported by the selected variant.
+#define PICO_PROBE_NOT_SUPPORTED_BY_THIS_DEVICE 0x00003005UL
+
+// The probe name is not in the list of enPicoConnectProbe enums.
+#define PICO_INVALID_PROBE_NAME 0x00003006UL
+
+// The number of colour settings are zero or a null pointer passed to the function.
+#define PICO_NO_PROBE_COLOUR_SETTINGS 0x00003007UL
+
+// Channel has no probe connected to it.
+#define PICO_NO_PROBE_CONNECTED_ON_REQUESTED_CHANNEL 0x00003008UL
+
+// Connected probe does not require calibration.
+#define PICO_PROBE_DOES_NOT_REQUIRE_CALIBRATION 0x00003009UL
+
+// Connected probe could not be calibrated - hardware fault is a possible cause.
+#define PICO_PROBE_CALIBRATION_FAILED 0x0000300AUL
+
+// A probe has been connected, but the version is not recognised.
+#define PICO_PROBE_VERSION_ERROR 0x0000300BUL
+
+// The channel with the frequency counter enabled has a probe connected that does not support this feature
+#define PICO_PROBE_DOES_NOT_SUPPORT_FREQUENCY_COUNTER 0x0000300CUL
+
+// The requested trigger time is to long for the selected variant.
+#define PICO_AUTO_TRIGGER_TIME_TOO_LONG   0x00004000UL
+
+// The MSO pod did not pass the validation checks.
+#define PICO_MSO_POD_VALIDATION_FAILED 0x00005000UL
+
+// No MSO pod found on the requested digital port.
+#define PICO_NO_MSO_POD_CONNECTED 0x00005001UL
+
+// the digital port enum value is not in the enPicoDigitalPortHysteresis declaration
+#define PICO_DIGITAL_PORT_HYSTERESIS_OUT_OF_RANGE 0x00005002UL
+
+#define PICO_MSO_POD_FAILED_UNIT 0x00005003UL
+
+// The device's EEPROM is corrupt. Contact Pico Technology support: https://www.picotech.com/tech-support.
+#define PICO_ATTENUATION_FAILED 0x00005004UL
+
+// a channel set to the 50Ohm Path has Tripped due to the input signal
+#define PICO_DC_50OHM_OVERVOLTAGE_TRIPPED 0x00005005UL
+
+// The MSO pod over current protection activated, unplug and replug the MSO pod 
+#define PICO_MSO_OVER_CURRENT_TRIPPED 0x00005006UL
+
+// Status error for when the device has overheated.
+#define PICO_NOT_RESPONDING_OVERHEATED 0x00005010UL
+
+// waiting for the device to capture timed out
+#define PICO_HARDWARE_CAPTURE_TIMEOUT 0x00006000UL
+
+// waiting for the device be ready for capture timed out
+#define PICO_HARDWARE_READY_TIMEOUT   0x00006001UL
+
+// the driver is performing a capture requested by RunStreaming or RunBlock
+// to interrupt this capture call Stop on the device first
+#define PICO_HARDWARE_CAPTURING_CALL_STOP   0x00006002UL
+
+// the number of samples is less than the minimum number allowed
+#define PICO_TOO_FEW_REQUESTED_STREAMING_SAMPLES 0x00007000UL
+
+// a streaming capture has been made but re-reading the data is not allowed
+#define PICO_STREAMING_REREAD_DATA_NOT_AVAILABLE 0x00007001UL
+
+// When requesting data only Raw and one of the following aggregation data types allowed
+//   - PICO_RATIO_MODE_AGGREGATE (Min Max),
+//     PICO_RATIO_MODE_DECIMATE,
+//     PICO_RATIO_MODE_AVERAGE and/or PICO_RATIO_MODE_SUM,
+//     PICO_RATIO_MODE_DISTRIBUTION
+//
+//	 average and sum are classed as one aggregation type
+#define PICO_STREAMING_COMBINATION_OF_RAW_DATA_AND_ONE_AGGREGATION_DATA_TYPE_ALLOWED 0x00007002UL
+
+// The time stamp per waveform segment has been reset.
+#define PICO_DEVICE_TIME_STAMP_RESET							0x01000000UL
+
+// When requesting the TriggerTimeOffset the trigger time has not been set.
+#define PICO_TRIGGER_TIME_NOT_REQUESTED						0x02000001UL
+
+// Trigger time buffer not set.
+#define PICO_TRIGGER_TIME_BUFFER_NOT_SET          0x02000002UL
+
+// The trigger time failed to be calculated.
+#define PICO_TRIGGER_TIME_FAILED_TO_CALCULATE     0x02000004UL
+
+// The trigger time failed to be calculated.
+#define PICO_TRIGGER_WITHIN_A_PRE_TRIGGER_FAILED_TO_CALCULATE 0x02000008UL
+
+// The trigger time stamp was not requested.
+#define PICO_TRIGGER_TIME_STAMP_NOT_REQUESTED			0x02000100UL
+
+// RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION cannot have a buffer set
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_DOES_NOT_REQUIRE_BUFFERS 0x02200000UL
+
+// it is not possible to set a buffer for RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION therefore
+// information is not available pertaining to samples
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_DOES_NOT_HAVE_BUFFERS 0x02200001UL
+
+// to get the trigger time use either GetTriggerInfo or GetTriggerTimeOffset api calls
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_USE_GETTRIGGERINFO 0x02200002UL
+
+
+// PICO_RATIO_MDOE_TRIGGER and RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION is not supported in streaming capture
+#define PICO_STREAMING_DOES_NOT_SUPPORT_TRIGGER_RATIO_MODES 0x02200003UL
+
+// only the PICO_TRIGGER_READ may be used to read PICO_RATIO_MODE_TRIGGER, and PICO_RATIO_MODE_TRIGGER_FOR_CALCULATION
+#define PICO_USE_THE_TRIGGER_READ 0x02200004UL
+
+// one of the PICO_DATA_READs should be used to read:
+// PICO_RATIO_MODE_RAW
+// PICO_RATIO_MODE_AGGREGATE
+// PICO_RATIO_MODE_DECIMATE
+// PICO_RATIO_MODE_AVERAGE
+#define PICO_USE_A_DATA_READ 0x02200005UL
+
+// trigger data always requires a PICO_INT16_T data type
+#define PICO_TRIGGER_READ_REQUIRES_INT16_T_DATA_TYPE 0x02200006UL
+
+// a ratio mode passed to the API call requires the number of samples to be greater than zero
+#define PICO_RATIO_MODE_REQUIRES_NUMBER_OF_SAMPLES_TO_BE_SET 0x02200007UL
+
+// Attempted to set up the signal generator with an inconsistent configuration.
+#define PICO_SIGGEN_SETTINGS_MISMATCH             0x03000010UL
+
+// The signal generator has been partially reconfigured and the new settings must be applied before it can be paused or restarted.
+#define PICO_SIGGEN_SETTINGS_CHANGED_CALL_APPLY   0x03000011UL
+
+// The wave type is not listed in enPicoWaveType.
+#define PICO_SIGGEN_WAVETYPE_NOT_SUPPORTED        0x03000012UL
+
+// The trigger type is not listed in enSigGenTrigType.
+#define PICO_SIGGEN_TRIGGERTYPE_NOT_SUPPORTED     0x03000013UL
+
+// The trigger source is not listed in enSigGenTrigSource.
+#define PICO_SIGGEN_TRIGGERSOURCE_NOT_SUPPORTED   0x03000014UL
+
+// The filter state is not listed in enPicoSigGenFilterState.
+#define PICO_SIGGEN_FILTER_STATE_NOT_SUPPORTED    0x03000015UL
+
+// The arbitrary waveform buffer is a null pointer.
+#define PICO_SIGGEN_NULL_PARAMETER                0x03000020UL
+
+// The arbitrary waveform buffer length is zero.
+#define PICO_SIGGEN_EMPTY_BUFFER_SUPPLIED         0x03000021UL
+
+// The sig gen voltage offset and peak to peak have not been set.
+#define PICO_SIGGEN_RANGE_NOT_SUPPLIED            0x03000022UL
+
+// The sig gen arbitrary waveform buffer not been set.
+#define PICO_SIGGEN_BUFFER_NOT_SUPPLIED           0x03000023UL
+
+// The sig gen frequency have not been set.
+#define PICO_SIGGEN_FREQUENCY_NOT_SUPPLIED        0x03000024UL
+
+// The sig gen sweep information has not been set.
+#define PICO_SIGGEN_SWEEP_INFO_NOT_SUPPLIED       0x03000025UL
+
+// The sig gen trigger information has not been set.
+#define PICO_SIGGEN_TRIGGER_INFO_NOT_SUPPLIED     0x03000026UL
+
+// The sig gen clock frequency have not been set.
+#define PICO_SIGGEN_CLOCK_FREQ_NOT_SUPPLIED       0x03000027UL
+
+// The sig gen arbitrary waveform buffer length is too long.
+#define PICO_SIGGEN_TOO_MANY_SAMPLES              0x03000030UL
+
+// The duty cycle value is out of range.
+#define PICO_SIGGEN_DUTYCYCLE_OUT_OF_RANGE        0x03000031UL
+
+// The number of cycles is out of range.
+#define PICO_SIGGEN_CYCLES_OUT_OF_RANGE           0x03000032UL
+
+// The pre-scaler is out of range.
+#define PICO_SIGGEN_PRESCALE_OUT_OF_RANGE         0x03000033UL
+
+// The sweep type is not listed in enPicoSweepType.
+#define PICO_SIGGEN_SWEEPTYPE_INVALID             0x03000034UL
+
+// A mismatch has occurred while checking the sweeps wave type.
+#define PICO_SIGGEN_SWEEP_WAVETYPE_MISMATCH       0x03000035UL
+
+// The sweeps or shots and trigger type are not valid when combined together.
+#define PICO_SIGGEN_INVALID_SWEEP_PARAMETERS      0x03000036UL
+
+// The sweep and prescaler are not valid when combined together.
+#define PICO_SIGGEN_SWEEP_PRESCALE_NOT_SUPPORTED  0x03000037UL
+
+// The potential applied to the AWG output exceeds the maximum voltage range of the AWG.
+#define PICO_AWG_OVER_VOLTAGE_RANGE               0x03000038UL
+
+// The reference signal cannot be locked to.
+#define PICO_NOT_LOCKED_TO_REFERENCE_FREQUENCY  0x03000039UL
+
+// (Linux only.) udev rules are incorrectly configured. The user does
+// not have read/write permissions on the device's file descriptor.
+#define PICO_PERMISSIONS_ERROR  0x03000040UL
+
+// The digital ports without analog channels are only allowed in 8-bit resolution.
+#define PICO_PORTS_WITHOUT_ANALOGUE_CHANNELS_ONLY_ALLOWED_IN_8BIT_RESOLUTION 0x03001000UL
+
+#define PICO_ANALOGUE_FRONTEND_MISSING 0x03003001UL
+#define PICO_FRONT_PANEL_MISSING 0x03003002UL
+#define PICO_ANALOGUE_FRONTEND_AND_FRONT_PANEL_MISSING 0x03003003UL
+
+// The digital board has reported an error to the driver
+#define PICO_DIGITAL_BOARD_HARDWARE_ERROR 0x03003800UL
+
+// checking if the firmware needs updating the updateRequired parameter is null
+#define PICO_FIRMWARE_UPDATE_REQUIRED_TO_USE_DEVICE_WITH_THIS_DRIVER		          0x03004000UL
+#define PICO_UPDATE_REQUIRED_NULL																				          0x03004001UL
+#define PICO_FIRMWARE_UP_TO_DATE																				          0x03004002UL
+#define PICO_FLASH_FAIL																									          0x03004003UL
+#define PICO_INTERNAL_ERROR_FIRMWARE_LENGTH_INVALID											          0x03004004UL
+#define PICO_INTERNAL_ERROR_FIRMWARE_NULL																          0x03004005UL
+#define PICO_FIRMWARE_FAILED_TO_BE_CHANGED															          0x03004006UL
+#define PICO_FIRMWARE_FAILED_TO_RELOAD																	          0x03004007UL
+#define PICO_FIRMWARE_FAILED_TO_BE_UPDATE																          0x03004008UL
+#define PICO_FIRMWARE_VERSION_OUT_OF_RANGE															          0x03004009UL
+
+#define PICO_OPTIONAL_BOOTLOADER_UPDATE_AVAILABLE_WITH_THIS_DRIVER	0x03005000UL
+#define PICO_BOOTLOADER_VERSION_NOT_AVAILABLE 0x03005001UL
+
+#define PICO_NO_APPS_AVAILABLE                                          0x03008000UL
+#define PICO_UNSUPPORTED_APP                                            0x03008001UL
+
+// the adc is powered down when trying to capture data
+#define PICO_ADC_POWERED_DOWN 0x03002000UL
+
+// An internal error has occurred and a watchdog timer has been called.
+#define PICO_WATCHDOGTIMER                        0x10000000UL
+
+// The picoipp.dll has not been found.
+#define PICO_IPP_NOT_FOUND                				0x10000001UL
+
+// A function in the picoipp.dll does not exist.
+#define PICO_IPP_NO_FUNCTION					            0x10000002UL
+
+// The Pico IPP call has failed.
+#define PICO_IPP_ERROR					                  0x10000003UL
+
+// Shadow calibration is not available on this device.
+#define PICO_SHADOW_CAL_NOT_AVAILABLE             0x10000004UL
+
+// Shadow calibration is currently disabled.
+#define PICO_SHADOW_CAL_DISABLED                  0x10000005UL
+
+// Shadow calibration error has occurred.
+#define PICO_SHADOW_CAL_ERROR                     0x10000006UL
+
+// The shadow calibration is corrupt.
+#define PICO_SHADOW_CAL_CORRUPT                   0x10000007UL
+
+// The memory on board the device has overflowed.
+#define PICO_DEVICE_MEMORY_OVERFLOW               0x10000008UL
+
+//The device Adc test failed.
+#define PICO_ADC_TEST_FAILURE                     0x10000010UL
+
+#define PICO_RESERVED_1														0x11000000UL
+
+// The PicoSource device is not ready to accept instructions.
+#define PICO_SOURCE_NOT_READY											0x20000000UL
+#define PICO_SOURCE_INVALID_BAUD_RATE							0x20000001UL
+#define PICO_SOURCE_NOT_OPENED_FOR_WRITE					0x20000002UL
+#define PICO_SOURCE_FAILED_TO_WRITE_DEVICE				0x20000003UL
+#define PICO_SOURCE_EEPROM_FAIL										0x20000004UL
+#define PICO_SOURCE_EEPROM_NOT_PRESENT 						0x20000005UL
+#define PICO_SOURCE_EEPROM_NOT_PROGRAMMED					0x20000006UL
+#define PICO_SOURCE_LIST_NOT_READY								0x20000007UL
+#define PICO_SOURCE_FTD2XX_NOT_FOUND							0x20000008UL
+#define PICO_SOURCE_FTD2XX_NO_FUNCTION						0x20000009UL
+
+typedef uint32_t PICO_STATUS;
+
+typedef enum enPicoStringValue
+{
+	PICO_SV_MEMORY,
+	PICO_SV_MEMORY_NO_OF_SEGMENTS,
+	PICO_SV_MEMORY_MAX_SAMPLES,
+
+	PICO_SV_NO_OF_CHANNELS,
+	PICO_SV_ARRAY_OF_CHANNELS,
+	PICO_SV_CHANNEL,
+	PICO_SV_CHANNEL_NAME,
+	PICO_SV_CHANNEL_RANGE,
+	PICO_SV_CHANNEL_COUPLING,
+	PICO_SV_CHANNEL_ENABLED,
+	PICO_SV_CHANNEL_ANALOGUE_OFFSET,
+	PICO_SV_CHANNEL_FILTER,
+
+	PICO_SV_TRIGGER,
+	PICO_SV_TRIGGER_AUXIO_OUTPUT_ENABLED,
+	PICO_SV_TRIGGER_AUTO_TRIGGER_MICROSECONDS,
+
+	PICO_SV_TRIGGER_PROPERTIES,
+	PICO_SV_NO_OF_TRIGGER_PROPERTIES,
+
+	PICO_SV_TRIGGER_PROPERTIES_CHANNEL,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_UPPER,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_UPPER_HYSTERESIS,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_LOWER,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_LOWER_HYSTERESIS,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_MODE,
+
+	PICO_SV_TRIGGER_ARRAY_OF_BLOCK_CONDITIONS,
+	PICO_SV_TRIGGER_NO_OF_BLOCK_CONDITIONS,
+	PICO_SV_TRIGGER_CONDITIONS,
+	PICO_SV_TRIGGER_NO_OF_CONDITIONS,
+	PICO_SV_TRIGGER_CONDITION_SOURCE,
+	PICO_SV_TRIGGER_CONDITION_STATE,
+
+	PICO_SV_TRIGGER_DIRECTION,
+	PICO_SV_TRIGGER_NO_OF_DIRECTIONS,
+	PICO_SV_TRIGGER_DIRECTION_CHANNEL,
+	PICO_SV_TRIGGER_DIRECTION_DIRECTION,
+
+	PICO_SV_TRIGGER_DELAY,
+	PICO_SV_TRIGGER_DELAY_MS,
+
+	PICO_SV_FREQUENCY_COUNTER,
+	PICO_SV_FREQUENCY_COUNTER_ENABLED,
+	PICO_SV_FREQUENCY_COUNTER_CHANNEL,
+	PICO_SV_FREQUENCY_COUNTER_RANGE,
+	PICO_SV_FREQUENCY_COUNTER_TRESHOLDMAJOR,
+	PICO_SV_FREQUENCY_COUNTER_TRESHOLDMINOR,
+
+	PICO_SV_PULSE_WIDTH_PROPERTIES,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_DIRECTION,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_LOWER,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_UPPER,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_TYPE,
+
+	PICO_SV_PULSE_WIDTH_ARRAY_OF_BLOCK_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_NO_OF_BLOCK_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_NO_OF_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_CONDITIONS_SOURCE,
+	PICO_SV_PULSE_WIDTH_CONDITIONS_STATE,
+
+	PICO_SV_SAMPLE_PROPERTIES,
+	PICO_SV_SAMPLE_PROPERTIES_PRE_TRIGGER_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_POST_TRIGGER_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_TIMEBASE,
+	PICO_SV_SAMPLE_PROPERTIES_NO_OF_CAPTURES,
+	PICO_SV_SAMPLE_PROPERTIES_RESOLUTION,
+
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_DOWN_SAMPLE_RATIO,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_DOWN_SAMPLE_RATIO_MODE,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_REQUERSTED_NO_OF_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_SEGMENT_INDEX_FROM,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_SEGMENT_INDEX_TO,
+
+	PICO_SV_SIGNAL_GENERATOR,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_WAVE_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_START_FREQUENCY,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_STOP_FREQUENCY,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_INCREMENT,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_DWELL_TIME,
+	PICO_SV_SIGNAL_GENERATOR_AWG,
+	PICO_SV_SIGNAL_GENERATOR_AWG_START_DELTA_PHASE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_STOP_DELTA_PHASE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_DELTA_PHASE_INCREMENT,
+	PICO_SV_SIGNAL_GENERATOR_AWG_DWELL_COUNT,
+	PICO_SV_SIGNAL_GENERATOR_AWG_INDEX_MODE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_WAVEFORM_SIZE,
+	PICO_SV_SIGNAL_GENERATOR_ARRAY_OF_AWG_WAVEFORM_VALUES,
+	PICO_SV_SIGNAL_GENERATOR_OFFSET_VOLTAGE,
+	PICO_SV_SIGNAL_GENERATOR_PK_TO_PK,
+	PICO_SV_SIGNAL_GENERATOR_OPERATION,
+	PICO_SV_SIGNAL_GENERATOR_SHOTS,
+	PICO_SV_SIGNAL_GENERATOR_SWEEPS,
+	PICO_SV_SIGNAL_GENERATOR_SWEEP_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_TRIGGER_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_TRIGGER_SOURCE,
+	PICO_SV_SIGNAL_GENERATOR_EXT_IN_THRESHOLD,
+
+	PICO_SV_ETS,
+	PICO_SV_ETS_STATE,
+	PICO_SV_ETS_CYCLE,
+	PICO_SV_ETS_INTERLEAVE,
+	PICO_SV_ETS_SAMPLE_TIME_PICOSECONDS
+
+} PICO_STRING_VALUE;
+
+#endif

+ 37 - 0
pico-tcp-service/pico-tcp/inc/PicoVersion.h

@@ -0,0 +1,37 @@
+/****************************************************************************
+ *
+ * Filename:    PicoVersion.h
+ * Copyright:   Pico Technology Limited 2018 - 2022
+ * Description:
+ *
+ * This header defines the version struct.
+ *
+ ****************************************************************************/
+
+#ifndef __PICOVERSION_H__
+#define __PICOVERSION_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#pragma pack(push, 1)
+
+typedef struct tPicoVersion
+{
+	int16_t major_;
+	int16_t minor_;
+	int16_t revision_;
+	int16_t build_;
+} PICO_VERSION;
+
+typedef struct tPicoFirmwareInfo {
+	PICO_INFO firmwareType;
+	PICO_VERSION currentVersion;
+	PICO_VERSION updateVersion;
+	uint16_t updateRequired;
+} PICO_FIRMWARE_INFO;
+
+#pragma pack(pop)
+
+#endif

+ 158 - 0
pico-tcp-service/pico-tcp/inc/pl1000Api.h

@@ -0,0 +1,158 @@
+/**************************************************************************
+*
+* Filename:    pl1000Api.h
+* Author:      MB & MAS
+* Description:
+*
+* This header defines the interface to driver routines for the
+* PicoLog 1000 Series Data Loggers.
+*
+* Copyright © 2009-2018 Pico Technology Ltd. All rights reserved.
+*
+*************************************************************************/
+#ifndef __PL1000API_H__
+#define  __PL1000API_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+	//	If you are dynamically linking pl1000.dll into your project #define DYNLINK
+	//  somewhere in your project before here.
+#ifdef DYNLINK
+  #define PREF1 typedef
+  #define PREF2
+  #define PREF3(x) (__stdcall *x)
+#else
+  #define PREF1
+  #ifdef _USRDLL
+    #define PREF2 __declspec(dllexport) __stdcall
+  #else
+    #define PREF2 __declspec(dllimport) __stdcall
+  #endif
+  #define PREF3(x) x
+  #endif
+  #define PREF4 __stdcall
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+
+typedef enum enPL1000Inputs
+{
+  PL1000_CHANNEL_1 = 1,
+  PL1000_CHANNEL_2,
+  PL1000_CHANNEL_3,
+  PL1000_CHANNEL_4,
+  PL1000_CHANNEL_5,
+  PL1000_CHANNEL_6,
+  PL1000_CHANNEL_7,
+  PL1000_CHANNEL_8,
+  PL1000_CHANNEL_9,
+  PL1000_CHANNEL_10,
+  PL1000_CHANNEL_11,
+	PL1000_CHANNEL_12,
+	PL1000_CHANNEL_13,
+	PL1000_CHANNEL_14,
+	PL1000_CHANNEL_15,
+	PL1000_CHANNEL_16,
+	PL1000_MAX_CHANNELS = PL1000_CHANNEL_16
+} PL1000_INPUTS;
+
+typedef enum enPL1000DO_Channel
+{
+	PL1000_DO_CHANNEL_0,
+	PL1000_DO_CHANNEL_1,
+	PL1000_DO_CHANNEL_2,
+	PL1000_DO_CHANNEL_3,
+	PL1000_DO_CHANNEL_MAX
+} PL1000_DO_CH;
+
+typedef enum enPL1000OpenProgress
+{
+  PL1000_OPEN_PROGRESS_FAIL     = -1,
+  PL1000_OPEN_PROGRESS_PENDING  = 0,
+  PL1000_OPEN_PROGRESS_COMPLETE = 1
+} PL1000_OPEN_PROGRESS;
+
+#define PL1000_MIN_PERIOD 100
+#define PL1000_MAX_PERIOD 1800
+
+
+#ifndef BM_DEFINED
+#define BM_DEFINED
+typedef enum _BLOCK_METHOD{BM_SINGLE, BM_WINDOW, BM_STREAM} BLOCK_METHOD;
+#endif
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000OpenUnit) (int16_t * handle);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000CloseUnit) (int16_t handle);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000GetUnitInfo)
+	(int16_t handle, int8_t * string, int16_t stringLength, int16_t * requiredSize, PICO_INFO info);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000SetDo) (int16_t handle, int16_t do_value, int16_t doNo);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000SetPulseWidth) (int16_t handle, uint16_t period, uint8_t cycle);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000Run) (int16_t handle, uint32_t no_of_values, BLOCK_METHOD method);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000Ready) (int16_t handle, int16_t * ready);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000Stop) (int16_t handle);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000MaxValue) (int16_t handle, uint16_t *maxValue);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000SetInterval)
+	(int16_t handle, uint32_t * us_for_block, uint32_t ideal_no_of_samples, int16_t * channels,int16_t no_of_channels);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000SetTrigger)
+	(int16_t handle, uint16_t enabled, uint16_t auto_trigger, uint16_t auto_ms, uint16_t channel, uint16_t dir, uint16_t threshold, uint16_t hysterisis, float delay);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000GetValues)
+	(int16_t handle, uint16_t * values, uint32_t * noOfValues, uint16_t * overflow, uint32_t * triggerIndex);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000GetTriggerTimeOffsetNs)	(int16_t handle, int64_t * time);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000GetSingle) (int16_t handle, PL1000_INPUTS channel, uint16_t *value);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000OpenUnitAsync) (int16_t * status);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000OpenUnitProgress) (int16_t * handle, int16_t * progress, int16_t * complete);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (pl1000PingUnit) (int16_t handle);
+
+#endif

+ 168 - 0
pico-tcp-service/pico-tcp/inc/plcm3Api.h

@@ -0,0 +1,168 @@
+/**************************************************************************
+*
+* Filename:    plcm3Api.h
+* Author:      MAS
+* Description:
+*
+* This header defines the interface to driver routines for the
+* PicoLog CM3 Data Logger.
+*
+* Copyright © 2011-2018 Pico Technology Ltd. All rights reserved.
+*
+*************************************************************************/
+#ifndef __PLCM3API_H__
+#define __PLCM3API_H__
+
+#include <stdint.h>
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+  //	If you are dynamically linking plcm3.dll into your project #define DYNLINK
+  //  somewhere in your project before here.
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+#else
+/* Define a 64-bit integer type */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+#endif
+
+#define PLCM3_MIN_WIRES 2
+#define PLCM3_MAX_WIRES 4
+
+typedef enum enPLCM3Channels
+{
+  PLCM3_CHANNEL_1 = 1,
+  PLCM3_CHANNEL_2,
+  PLCM3_CHANNEL_3,
+  PLCM3_MAX_CHANNELS = PLCM3_CHANNEL_3
+} PLCM3_CHANNELS;
+
+typedef enum enPLCM3DataType
+{
+  PLCM3_OFF,
+  PLCM3_1_MILLIVOLT,
+  PLCM3_10_MILLIVOLTS,
+  PLCM3_100_MILLIVOLTS,
+  PLCM3_VOLTAGE,
+PLCM3_MAX_DATA_TYPES
+} PLCM3_DATA_TYPES;
+
+typedef enum enPLCM3IpDetailsType
+{
+  PLCM3_IDT_GET,
+  PLCM3_IDT_SET,
+} PLCM3_IP_DETAILS_TYPE;
+
+typedef enum enPLCM3CommunicationType
+{
+  PLCM3_CT_USB = 0x00000001,
+  PLCM3_CT_ETHERNET = 0x00000002,
+  PLCM3_CT_ALL = 0xFFFFFFFF
+}PLCM3_COMMUNICATION_TYPE;
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3Enumerate)
+(
+  int8_t   *details,
+  uint32_t *length,
+  PLCM3_COMMUNICATION_TYPE type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (PLCM3OpenUnit)
+(
+  int16_t * handle,
+  int8_t  * serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3OpenUnitViaIp)
+(
+  int16_t * handle,
+  int8_t  * serial,
+  int8_t  * ipAddress
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3CloseUnit)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3IpDetails)
+(
+  int16_t   handle,
+  int16_t  *enabled,
+  int8_t   *ipaddress,
+  uint16_t *length,
+  uint16_t *listeningPort,
+  PLCM3_IP_DETAILS_TYPE type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3GetUnitInfo)
+(
+  int16_t handle,
+  int8_t * string,
+  int16_t stringLength,
+  int16_t * requiredSize,
+  PICO_INFO info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3SetChannel)
+(
+  int16_t handle,
+  PLCM3_CHANNELS channel,
+  PLCM3_DATA_TYPES type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3SetMains)
+(
+  int16_t handle,
+  uint16_t sixtyHertz
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (PLCM3GetValue)
+(
+  int16_t handle,
+  PLCM3_CHANNELS channel,
+  int32_t * value
+);
+#endif

+ 607 - 0
pico-tcp-service/pico-tcp/inc/ps2000.h

@@ -0,0 +1,607 @@
+/****************************************************************************
+ *
+ * Filename:    ps2000.h
+ * Author:      MTB & MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 2000 Series PC Oscilloscopes.
+ *
+ * Copyright � 2005 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef PS2000_H
+#define PS2000_H
+
+#include <stdint.h>
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+#ifdef PREF4
+  #undef PREF4
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+/*  If you are dynamically linking ps2000.dll into your project #define DYNLINK here
+ */
+#ifdef WIN32
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+  #define PREF4 __stdcall
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+#define PS2000_FIRST_USB  1
+#define PS2000_LAST_USB   127
+
+/* Maximum number of PS2000 units that can be opened at once
+ */
+#define PS2000_MAX_UNITS (PS2000_LAST_USB - PS2000_FIRST_USB + 1)
+
+#define PS2000_MAX_TIMEBASE  19
+
+#define PS2105_MAX_TIMEBASE 20
+#define PS2104_MAX_TIMEBASE 19
+
+#define PS2200_MAX_TIMEBASE 23
+
+#define PS2000_MAX_OVERSAMPLE 256
+
+#define PS2105_MAX_ETS_CYCLES  250
+#define PS2105_MAX_ETS_INTERLEAVE  50
+
+#define PS2104_MAX_ETS_CYCLES  125
+#define PS2104_MAX_ETS_INTERLEAVE  25
+
+#define PS2203_MAX_ETS_CYCLES  250
+#define PS2203_MAX_ETS_INTERLEAVE 50
+
+#define PS2204_MAX_ETS_CYCLES  250
+#define PS2204_MAX_ETS_INTERLEAVE 40
+
+#define PS2205_MAX_ETS_CYCLES  250
+#define PS2205_MAX_ETS_INTERLEAVE 40
+
+#define PS2000_MIN_ETS_CYCLES_INTERLEAVE_RATIO 1
+#define PS2000_MAX_ETS_CYCLES_INTERLEAVE_RATIO  10
+
+#define PS2000_MIN_SIGGEN_FREQ 0.0f
+#define PS2000_MAX_SIGGEN_FREQ 100000.0f
+
+
+/* Although the PS2000 uses an 8-bit ADC, it is usually possible to
+ * oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+
+#define PS2000_MAX_VALUE 32767
+#define PS2000_MIN_VALUE -32767
+#define PS2000_LOST_DATA -32768
+
+typedef enum enPS2000Channel
+{
+  PS2000_CHANNEL_A,
+  PS2000_CHANNEL_B,
+  PS2000_CHANNEL_C,
+  PS2000_CHANNEL_D,
+  PS2000_EXTERNAL,
+  PS2000_MAX_CHANNELS = PS2000_EXTERNAL,
+  PS2000_NONE,
+}  PS2000_CHANNEL;
+
+typedef enum enPS2000Range
+{
+  PS2000_10MV,
+  PS2000_20MV,
+  PS2000_50MV,
+  PS2000_100MV,
+  PS2000_200MV,
+  PS2000_500MV,
+  PS2000_1V,
+  PS2000_2V,
+  PS2000_5V,
+  PS2000_10V,
+  PS2000_20V,
+  PS2000_50V,
+  PS2000_MAX_RANGES
+}  PS2000_RANGE;
+
+typedef enum enPS2000TimeUnits
+  {
+  PS2000_FS,
+  PS2000_PS,
+  PS2000_NS,
+  PS2000_US,
+  PS2000_MS,
+  PS2000_S,
+  PS2000_MAX_TIME_UNITS,
+  }  PS2000_TIME_UNITS;
+
+typedef enum enPS2000Error
+  {
+  PS2000_OK,
+  PS2000_MAX_UNITS_OPENED,  // more than PS2000_MAX_UNITS
+  PS2000_MEM_FAIL,          //not enough RAM on host machine
+  PS2000_NOT_FOUND,         //cannot find device
+  PS2000_FW_FAIL,           //unabled to download firmware
+  PS2000_NOT_RESPONDING,
+  PS2000_CONFIG_FAIL,       //missing or corrupted configuration settings
+  PS2000_OS_NOT_SUPPORTED,  //need to use win98SE (or later) or win2k (or later)
+  PS2000_PICOPP_TOO_OLD,
+  }  PS2000_ERROR;
+
+typedef enum enPS2000Info
+{
+  PS2000_DRIVER_VERSION,
+  PS2000_USB_VERSION,
+  PS2000_HARDWARE_VERSION,
+  PS2000_VARIANT_INFO,
+  PS2000_BATCH_AND_SERIAL,
+  PS2000_CAL_DATE,
+  PS2000_ERROR_CODE,
+  PS2000_KERNEL_DRIVER_VERSION,
+  PS2000_DRIVER_PATH
+}  PS2000_INFO;
+
+typedef enum enPS2000TriggerDirection
+  {
+  PS2000_RISING,
+  PS2000_FALLING,
+  PS2000_MAX_DIRS
+  }  PS2000_TDIR;
+
+typedef enum enPS2000OpenProgress
+  {
+  PS2000_OPEN_PROGRESS_FAIL     = -1,
+  PS2000_OPEN_PROGRESS_PENDING  =  0,
+  PS2000_OPEN_PROGRESS_COMPLETE =  1
+  } PS2000_OPEN_PROGRESS;
+
+typedef enum enPS2000EtsMode
+  {
+  PS2000_ETS_OFF,   // ETS disabled
+  PS2000_ETS_FAST,  // Return ready as soon as requested no of interleaves is available
+  PS2000_ETS_SLOW,  // Return ready every time a new set of no_of_cycles is collected
+  PS2000_ETS_MODES_MAX
+  }  PS2000_ETS_MODE;
+
+typedef enum enPS2000ButtonState
+  {
+  PS2000_NO_PRESS,
+  PS2000_SHORT_PRESS,
+  PS2000_LONG_PRESS
+  } PS2000_BUTTON_STATE;
+
+typedef enum enPS2000SweepType
+{
+  PS2000_UP,
+  PS2000_DOWN,
+  PS2000_UPDOWN,
+  PS2000_DOWNUP,
+  MAX_SWEEP_TYPES
+} PS2000_SWEEP_TYPE;
+
+typedef enum enPS2000WaveType
+{
+  PS2000_SINE,
+  PS2000_SQUARE,
+  PS2000_TRIANGLE,
+  PS2000_RAMPUP,
+  PS2000_RAMPDOWN,
+  PS2000_DC_VOLTAGE,
+  PS2000_GAUSSIAN,
+  PS2000_SINC,
+  PS2000_HALF_SINE,
+} PS2000_WAVE_TYPE;
+
+typedef void (PREF4 *GetOverviewBuffersMaxMin)
+(
+  int16_t **overviewBuffers,
+  int16_t   overflow,
+  uint32_t  triggeredAt,
+  int16_t   triggered,
+  int16_t   auto_stop,
+  uint32_t  nValues
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_open_unit)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_get_unit_info)
+(
+  int16_t  handle,
+  int8_t  *string,
+  int16_t  string_length,
+  int16_t  line
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_flash_led)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_close_unit)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_channel)
+(
+  int16_t  handle,
+  int16_t  channel,
+  int16_t  enabled,
+  int16_t  dc,
+  int16_t  range
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_get_timebase)
+(
+  int16_t  handle,
+  int16_t  timebase,
+  int32_t  no_of_samples,
+  int32_t *time_interval,
+  int16_t *time_units,
+  int16_t  oversample,
+  int32_t *max_samples
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_trigger)
+(
+  int16_t  handle,
+  int16_t  source,
+  int16_t  threshold,
+  int16_t  direction,
+  int16_t  delay,
+  int16_t  auto_trigger_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_trigger2)
+(
+  int16_t  handle,
+  int16_t  source,
+  int16_t  threshold,
+  int16_t  direction,
+  float    delay,
+  int16_t  auto_trigger_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_run_block)
+(
+  int16_t handle,
+  int32_t  no_of_values,
+  int16_t  timebase,
+  int16_t  oversample,
+  int32_t * time_indisposed_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_run_streaming)
+(
+  int16_t  handle,
+  int16_t  sample_interval_ms,
+  int32_t  max_samples,
+  int16_t  windowed
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_run_streaming_ns)
+(
+  int16_t            handle,
+  uint32_t           sample_interval,
+  PS2000_TIME_UNITS  time_units,
+  uint32_t           max_samples,
+  int16_t            auto_stop,
+  uint32_t           noOfSamplesPerAggregate,
+  uint32_t           overview_buffer_size);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_ready)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_stop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps2000_get_values)
+(
+  int16_t  handle,
+  int16_t *buffer_a,
+  int16_t *buffer_b,
+  int16_t *buffer_c,
+  int16_t *buffer_d,
+  int16_t *overflow,
+  int32_t  no_of_values
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps2000_get_times_and_values)
+(
+  int16_t  handle,
+  int32_t *times,
+  int16_t *buffer_a,
+  int16_t *buffer_b,
+  int16_t *buffer_c,
+  int16_t *buffer_d,
+  int16_t *overflow,
+  int16_t  time_units,
+  int32_t  no_of_values
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_last_button_press)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps2000_set_ets)
+(
+  int16_t  handle,
+  int16_t  mode,
+  int16_t  ets_cycles,
+  int16_t  ets_interleave
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_led)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_open_unit_async)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_open_unit_progress)
+(
+  int16_t *handle,
+  int16_t *progress_percent
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000_get_streaming_last_values)
+(
+  int16_t  handle,
+  GetOverviewBuffersMaxMin
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000_overview_buffer_status)
+(
+  int16_t  handle,
+  int16_t *previous_buffer_overrun
+);
+
+PREF0 PREF1 uint32_t PREF2 PREF3 (ps2000_get_streaming_values)
+(
+  int16_t  handle,
+  double   *start_time,
+  int16_t  *pbuffer_a_max,
+  int16_t  *pbuffer_a_min,
+  int16_t  *pbuffer_b_max,
+  int16_t  *pbuffer_b_min,
+  int16_t  *pbuffer_c_max,
+  int16_t  *pbuffer_c_min,
+  int16_t  *pbuffer_d_max,
+  int16_t  *pbuffer_d_min,
+  int16_t  *overflow,
+  uint32_t *triggerAt,
+  int16_t  *triggered,
+  uint32_t  no_of_values,
+  uint32_t  noOfSamplesPerAggregate
+);
+
+PREF0 PREF1 uint32_t PREF2 PREF3 (ps2000_get_streaming_values_no_aggregation)
+(
+  int16_t handle,
+  double *start_time,
+  int16_t * pbuffer_a,
+  int16_t * pbuffer_b,
+  int16_t * pbuffer_c,
+  int16_t * pbuffer_d,
+  int16_t * overflow,
+  uint32_t * triggerAt,
+  int16_t * trigger,
+  uint32_t no_of_values
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_light)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_sig_gen_arbitrary)
+ (
+  int16_t            handle,
+  int32_t            offsetVoltage,
+  uint32_t           pkToPk,
+  uint32_t           startDeltaPhase,
+  uint32_t           stopDeltaPhase,
+  uint32_t           deltaPhaseIncrement,
+  uint32_t           dwellCount,
+  uint8_t           *arbitraryWaveform,
+  int32_t            arbitraryWaveformSize,
+  PS2000_SWEEP_TYPE  sweepType,
+  uint32_t           sweeps
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps2000_set_sig_gen_built_in)
+(
+  int16_t            handle,
+  int32_t            offsetVoltage,
+  uint32_t           pkToPk,
+  PS2000_WAVE_TYPE   waveType,
+  float              startFrequency,
+  float              stopFrequency,
+  float              increment,
+  float              dwellTime,
+  PS2000_SWEEP_TYPE  sweepType,
+  uint32_t           sweeps
+);
+
+//===========================================================
+// Adv Trigger
+//===========================================================
+typedef enum enPS2000ThresholdDirection
+{
+  PS2000_ABOVE,
+  PS2000_BELOW,
+  PS2000_ADV_RISING,
+  PS2000_ADV_FALLING,
+  PS2000_RISING_OR_FALLING,
+  PS2000_INSIDE = PS2000_ABOVE,
+  PS2000_OUTSIDE = PS2000_BELOW,
+  PS2000_ENTER = PS2000_ADV_RISING,
+  PS2000_EXIT = PS2000_ADV_FALLING,
+  PS2000_ENTER_OR_EXIT = PS2000_RISING_OR_FALLING,
+  PS2000_ADV_NONE = PS2000_ADV_RISING
+} PS2000_THRESHOLD_DIRECTION;
+
+typedef enum enPS2000ThresholdMode
+{
+  PS2000_LEVEL,
+  PS2000_WINDOW
+} PS2000_THRESHOLD_MODE;
+
+typedef enum enPS2000TriggerState
+{
+  PS2000_CONDITION_DONT_CARE,
+  PS2000_CONDITION_TRUE,
+  PS2000_CONDITION_FALSE,
+  PS2000_CONDITION_MAX
+} PS2000_TRIGGER_STATE;
+
+typedef enum enPS2000PulseWidthType
+{
+  PS2000_PW_TYPE_NONE,
+  PS2000_PW_TYPE_LESS_THAN,
+  PS2000_PW_TYPE_GREATER_THAN,
+  PS2000_PW_TYPE_IN_RANGE,
+  PS2000_PW_TYPE_OUT_OF_RANGE
+} PS2000_PULSE_WIDTH_TYPE;
+
+#pragma pack(1)
+typedef struct tPS2000TriggerChannelProperties
+{
+  int16_t thresholdMajor;
+  int16_t thresholdMinor;
+  uint16_t hysteresis;
+  int16_t channel;
+  PS2000_THRESHOLD_MODE thresholdMode;
+} PS2000_TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tPS2000TriggerConditions
+{
+  PS2000_TRIGGER_STATE channelA;
+  PS2000_TRIGGER_STATE channelB;
+  PS2000_TRIGGER_STATE channelC;
+  PS2000_TRIGGER_STATE channelD;
+  PS2000_TRIGGER_STATE external;
+  PS2000_TRIGGER_STATE pulseWidthQualifier;
+} PS2000_TRIGGER_CONDITIONS;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tPS2000PwqConditions
+{
+  PS2000_TRIGGER_STATE channelA;
+  PS2000_TRIGGER_STATE channelB;
+  PS2000_TRIGGER_STATE channelC;
+  PS2000_TRIGGER_STATE channelD;
+  PS2000_TRIGGER_STATE external;
+} PS2000_PWQ_CONDITIONS;
+#pragma pack()
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000SetAdvTriggerChannelProperties)
+(
+  int16_t                            handle,
+  PS2000_TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                            nChannelProperties,
+  int32_t                            autoTriggerMilliseconds
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000SetAdvTriggerChannelConditions)
+(
+  int16_t                    handle,
+  PS2000_TRIGGER_CONDITIONS *conditions,
+  int16_t                    nConditions
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000SetAdvTriggerChannelDirections)
+(
+  int16_t                     handle,
+  PS2000_THRESHOLD_DIRECTION  channelA,
+  PS2000_THRESHOLD_DIRECTION  channelB,
+  PS2000_THRESHOLD_DIRECTION  channelC,
+  PS2000_THRESHOLD_DIRECTION  channelD,
+  PS2000_THRESHOLD_DIRECTION  ext
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000SetPulseWidthQualifier)
+(
+  int16_t                     handle,
+  PS2000_PWQ_CONDITIONS      *conditions,
+  int16_t                     nConditions,
+  PS2000_THRESHOLD_DIRECTION  direction,
+  uint32_t                    lower,
+  uint32_t                    upper,
+  PS2000_PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000SetAdvTriggerDelay)
+(
+  int16_t   handle,
+  uint32_t  delay,
+  float     preTriggerDelay
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps2000PingUnit)
+(
+  int16_t  handle
+);
+
+#endif /* not defined PS2000_H */

+ 2948 - 0
pico-tcp-service/pico-tcp/inc/ps2000aApi.h

@@ -0,0 +1,2948 @@
+/****************************************************************************
+ *
+ * Filename:    ps2000aApi.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *	PicoScope 2000A and 2000B Series, and 2205 MSO PC Oscilloscopes.
+ *
+ * Copyright � 2010 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS2000AAPI_H__
+#define __PS2000AAPI_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#ifdef __cplusplus
+	#define PREF0 extern "C"
+	#define TYPE_ENUM
+#else
+	#define PREF0
+	#define TYPE_ENUM enum
+#endif
+
+#ifdef WIN32
+	#ifdef PREF1
+	  #undef PREF1
+	#endif
+	#ifdef PREF2
+	  #undef PREF2
+	#endif
+	#ifdef PREF3
+	  #undef PREF3
+	#endif
+	/*	If you are dynamically linking ps2000a.dll into your project #define DYNLINK here
+	 */
+	#ifdef DYNLINK
+	  #define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (__stdcall *x)
+	#else
+	  #define PREF1
+		#ifdef _USRDLL
+			#define PREF2 __declspec(dllexport) __stdcall
+		#else
+			#define PREF2 __declspec(dllimport) __stdcall
+		#endif
+	  #define PREF3(x) x
+	#endif
+#else
+	/* Define a 64-bit integer type */
+
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+	#define __stdcall
+#endif
+
+/* Depending on the adc; oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+
+// covers the PS2208 and PS2208A
+#define PS2208_MAX_ETS_CYCLES	500
+#define PS2208_MAX_INTERLEAVE	 20
+
+// covers the PS2207 and PS2207A
+#define PS2207_MAX_ETS_CYCLES	500
+#define PS2207_MAX_INTERLEAVE	 20
+
+// covers the PS2206 and PS2206A
+#define PS2206_MAX_ETS_CYCLES	250
+#define PS2206_MAX_INTERLEAVE	 10
+
+#define PS2000A_EXT_MAX_VALUE  32767
+#define PS2000A_EXT_MIN_VALUE -32767
+
+#define PS2000A_MAX_LOGIC_LEVEL	 32767
+#define PS2000A_MIN_LOGIC_LEVEL -32767
+
+#define MIN_SIG_GEN_FREQ 0.0f
+#define MAX_SIG_GEN_FREQ 20000000.0f
+
+#define PS2000A_MAX_SIG_GEN_BUFFER_SIZE 8192
+#define PS2000A_MIN_SIG_GEN_BUFFER_SIZE 1
+#define PS2000A_MIN_DWELL_COUNT				3
+#define PS2000A_MAX_SWEEPS_SHOTS				((1 << 30) - 1)
+
+#define PS2000A_MAX_ANALOGUE_OFFSET_50MV_200MV	 0.250f
+#define PS2000A_MIN_ANALOGUE_OFFSET_50MV_200MV	-0.250f
+#define PS2000A_MAX_ANALOGUE_OFFSET_500MV_2V		 2.500f
+#define PS2000A_MIN_ANALOGUE_OFFSET_500MV_2V		-2.500f
+#define PS2000A_MAX_ANALOGUE_OFFSET_5V_20V			 20.f
+#define PS2000A_MIN_ANALOGUE_OFFSET_5V_20V			-20.f
+
+// supported by the PS2206/PS2206A, PS2207/PS2207A, PS2208/PS2208A only
+#define PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN 0xFFFFFFFF
+
+/// <summary>
+/// The analogue channels index
+/// </summary>
+typedef enum enPS2000AChannelBufferIndex
+{
+	PS2000A_CHANNEL_A_MAX,
+	PS2000A_CHANNEL_A_MIN,
+	PS2000A_CHANNEL_B_MAX,
+	PS2000A_CHANNEL_B_MIN,
+	PS2000A_CHANNEL_C_MAX,
+	PS2000A_CHANNEL_C_MIN,
+	PS2000A_CHANNEL_D_MAX,
+	PS2000A_CHANNEL_D_MIN,
+	PS2000A_MAX_CHANNEL_BUFFERS
+} PS2000A_CHANNEL_BUFFER_INDEX;
+
+/// <summary>
+/// The analogue channels and trigger channels supported by the devices
+/// </summary>
+typedef enum enPS2000AChannel
+{
+	PS2000A_CHANNEL_A,
+	PS2000A_CHANNEL_B,
+	PS2000A_CHANNEL_C,
+	PS2000A_CHANNEL_D,
+	PS2000A_EXTERNAL,
+	PS2000A_MAX_CHANNELS = PS2000A_EXTERNAL,
+	PS2000A_TRIGGER_AUX,
+	PS2000A_MAX_TRIGGER_SOURCES
+
+}	PS2000A_CHANNEL;
+
+/// <summary>
+/// MSO models only.
+/// Defines how the analgoue and digital triggers are combined.
+/// </summary>
+
+typedef enum enPS2000ATriggerOperand
+{
+	/// <summary>
+	/// Ignore the trigger settings
+	/// </summary>
+	PS2000A_OPERAND_NONE,
+	/// <summary>
+	/// Fire when either trigger is activated.
+	/// </summary>
+	PS2000A_OPERAND_OR,
+	/// <summary>
+	/// Fire when both triggers are activated
+	/// </summary>
+	PS2000A_OPERAND_AND,
+	/// <summary>
+	/// Fire when one trigger is activated.
+	/// </summary>
+	PS2000A_OPERAND_THEN
+} PS2000A_TRIGGER_OPERAND;
+
+/// <summary>
+/// MSO ports
+/// </summary>
+typedef enum enPS2000DigitalPort
+{
+	PS2000A_DIGITAL_PORT0 = 0x80, // digital channel 0 - 7
+	PS2000A_DIGITAL_PORT1,			 // digital channel 8 - 15
+	PS2000A_DIGITAL_PORT2,			 // digital channel 16 - 23
+	PS2000A_DIGITAL_PORT3,			 // digital channel 24 - 31
+	PS2000A_MAX_DIGITAL_PORTS = (PS2000A_DIGITAL_PORT3 - PS2000A_DIGITAL_PORT0) + 1
+}	PS2000A_DIGITAL_PORT;
+
+
+/// <summary>
+/// MSO digital channels
+/// </summary>
+typedef enum enPS2000ADigitalChannel
+{
+	PS2000A_DIGITAL_CHANNEL_0,
+	PS2000A_DIGITAL_CHANNEL_1,
+	PS2000A_DIGITAL_CHANNEL_2,
+	PS2000A_DIGITAL_CHANNEL_3,
+	PS2000A_DIGITAL_CHANNEL_4,
+	PS2000A_DIGITAL_CHANNEL_5,
+	PS2000A_DIGITAL_CHANNEL_6,
+	PS2000A_DIGITAL_CHANNEL_7,
+	PS2000A_DIGITAL_CHANNEL_8,
+	PS2000A_DIGITAL_CHANNEL_9,
+	PS2000A_DIGITAL_CHANNEL_10,
+	PS2000A_DIGITAL_CHANNEL_11,
+	PS2000A_DIGITAL_CHANNEL_12,
+	PS2000A_DIGITAL_CHANNEL_13,
+	PS2000A_DIGITAL_CHANNEL_14,
+	PS2000A_DIGITAL_CHANNEL_15,
+	PS2000A_DIGITAL_CHANNEL_16,
+	PS2000A_DIGITAL_CHANNEL_17,
+	PS2000A_DIGITAL_CHANNEL_18,
+	PS2000A_DIGITAL_CHANNEL_19,
+	PS2000A_DIGITAL_CHANNEL_20,
+	PS2000A_DIGITAL_CHANNEL_21,
+	PS2000A_DIGITAL_CHANNEL_22,
+	PS2000A_DIGITAL_CHANNEL_23,
+	PS2000A_DIGITAL_CHANNEL_24,
+	PS2000A_DIGITAL_CHANNEL_25,
+	PS2000A_DIGITAL_CHANNEL_26,
+	PS2000A_DIGITAL_CHANNEL_27,
+	PS2000A_DIGITAL_CHANNEL_28,
+	PS2000A_DIGITAL_CHANNEL_29,
+	PS2000A_DIGITAL_CHANNEL_30,
+	PS2000A_DIGITAL_CHANNEL_31,
+	PS2000A_MAX_DIGITAL_CHANNELS
+} PS2000A_DIGITAL_CHANNEL;
+
+/// <summary>
+/// Ranges that the channels are set to:
+/// Not all ranges are supported by every variant
+/// </summary>
+typedef enum enPS2000ARange
+{
+	PS2000A_10MV,
+	PS2000A_20MV,
+	PS2000A_50MV,
+	PS2000A_100MV,
+	PS2000A_200MV,
+	PS2000A_500MV,
+	PS2000A_1V,
+	PS2000A_2V,
+	PS2000A_5V,
+	PS2000A_10V,
+	PS2000A_20V,
+	PS2000A_50V,
+	PS2000A_MAX_RANGES,
+} PS2000A_RANGE;
+
+/// <summary>
+/// Available coupling modes.
+/// </summary>
+typedef enum enPS2000ACoupling
+{
+	PS2000A_AC,
+	PS2000A_DC
+} PS2000A_COUPLING;
+
+typedef enum enPS2000AChannelInfo
+{
+	PS2000A_CI_RANGES,
+} PS2000A_CHANNEL_INFO;
+
+/// <summary>
+/// Ets modes avialable
+/// </summary>
+typedef enum enPS2000AEtsMode
+{
+	/// <summary>
+	/// disables
+	/// </summary>
+  PS2000A_ETS_OFF,
+	/// <summary>
+	/// enables ETS and provides etsCycles of data, which may contain data from previously returned cycles.
+	/// </summary>
+  PS2000A_ETS_FAST,
+	/// <summary>
+	/// enables ETS and provides fresh data every etsCycles. This
+	/// mode takes longer to provide each data set, but the data sets are more stable and
+	/// are guaranteed to contain only new data.
+	/// </summary>
+	PS2000A_ETS_SLOW,
+
+  PS2000A_ETS_MODES_MAX
+  }	PS2000A_ETS_MODE;
+
+/// <summary>
+/// Time units that the time paramaters are using.
+/// </summary>
+typedef enum enPS2000ATimeUnits
+  {
+  PS2000A_FS,
+  PS2000A_PS,
+  PS2000A_NS,
+  PS2000A_US,
+  PS2000A_MS,
+  PS2000A_S,
+  PS2000A_MAX_TIME_UNITS,
+  }	PS2000A_TIME_UNITS;
+
+/// <summary>
+/// whether the frequency will sweep from startFrequency to
+/// stopFrequency, or in the opposite direction, or repeatedly reverse direction
+/// </summary>
+typedef enum enPS2000ASweepType
+{
+	PS2000A_UP,
+	PS2000A_DOWN,
+	PS2000A_UPDOWN,
+	PS2000A_DOWNUP,
+	PS2000A_MAX_SWEEP_TYPES
+} PS2000A_SWEEP_TYPE;
+
+/// <summary>
+/// Built in waveform types
+/// </summary>
+typedef enum enPS2000AWaveType
+{
+	PS2000A_SINE,
+	PS2000A_SQUARE,
+	PS2000A_TRIANGLE,
+	PS2000A_RAMP_UP,
+	PS2000A_RAMP_DOWN,
+	PS2000A_SINC,
+	PS2000A_GAUSSIAN,
+	PS2000A_HALF_SINE,
+	PS2000A_DC_VOLTAGE,
+	PS2000A_MAX_WAVE_TYPES
+} PS2000A_WAVE_TYPE;
+
+/// <summary>
+/// The type of waveform to be produced, specified by one of the following
+/// </summary>
+typedef enum enPS2000AExtraOperations
+{
+	/// <summary>
+	/// Normal signal generator operation specified by wavetype.
+	/// </summary>
+	PS2000A_ES_OFF,
+	/// <summary>
+	/// The signal generator produces white noise and ignores all settings except pkToPk and offsetVoltage.
+	/// </summary>
+	PS2000A_WHITENOISE,
+	/// <summary>
+	/// produces a pseudorandom random binary sequence with a bit rate
+	/// specified by the start and stop frequency.
+	/// </summary>
+	PS2000A_PRBS // Pseudo-Random Bit Stream
+} PS2000A_EXTRA_OPERATIONS;
+
+
+#define PS2000A_SINE_MAX_FREQUENCY				1000000.f
+#define PS2000A_SQUARE_MAX_FREQUENCY			1000000.f
+#define PS2000A_TRIANGLE_MAX_FREQUENCY		1000000.f
+#define PS2000A_SINC_MAX_FREQUENCY				1000000.f
+#define PS2000A_RAMP_MAX_FREQUENCY				1000000.f
+#define PS2000A_HALF_SINE_MAX_FREQUENCY		1000000.f
+#define PS2000A_GAUSSIAN_MAX_FREQUENCY		1000000.f
+#define PS2000A_PRBS_MAX_FREQUENCY				1000000.f
+#define PS2000A_PRBS_MIN_FREQUENCY					 0.03f
+#define PS2000A_MIN_FREQUENCY			  				 0.03f
+
+/// <summary>
+/// The type of trigger that will be applied to the signal generator
+/// </summary>
+typedef enum enPS2000ASigGenTrigType
+{
+	/// <summary>
+	/// Trigger on rising edge
+	/// </summary>
+	PS2000A_SIGGEN_RISING,
+	/// <summary>
+	/// Trigger on falling edge
+	/// </summary>
+	PS2000A_SIGGEN_FALLING,
+	/// <summary>
+	/// Run while trigger is high
+	/// </summary>
+	PS2000A_SIGGEN_GATE_HIGH,
+	/// <summary>
+	/// Run while trigger is low
+	/// </summary>
+	PS2000A_SIGGEN_GATE_LOW
+} PS2000A_SIGGEN_TRIG_TYPE;
+
+/// <summary>
+/// The source that will trigger the signal generator
+/// </summary>
+typedef enum enPS2000ASigGenTrigSource
+{
+	/// <summary>
+	/// Run without waiting for trigger
+	/// </summary>
+	PS2000A_SIGGEN_NONE,
+	/// <summary>
+	/// Use scope trigger
+	/// </summary
+	PS2000A_SIGGEN_SCOPE_TRIG,
+	/// <summary>
+	/// Use AUXIO input
+	/// </summary>
+	PS2000A_SIGGEN_AUX_IN,
+	/// <summary>
+	/// Use external input
+	/// </summary>
+	PS2000A_SIGGEN_EXT_IN,
+	/// <summary>
+	/// Wait for software trigger
+	/// </summary>
+	PS2000A_SIGGEN_SOFT_TRIG
+} PS2000A_SIGGEN_TRIG_SOURCE;
+
+/// <summary>
+/// AWG index modes
+/// </summary>
+typedef enum enPS2000AIndexMode
+{
+	/// <summary>
+	/// The generator outputs the raw contents of the buffer repeatedly .
+	/// </summary>
+	PS2000A_SINGLE,
+	/// <summary>
+	/// The generator outputs the contents of the buffer from beginning to end, and then does a second pass in the reverse
+	/// direction through the buffer
+	/// </summary>
+	PS2000A_DUAL,
+	/// <summary>
+	/// This is similiar to the Dual but passes through the buffer four time inverting, and inverting reversed
+	/// </summary>
+	PS2000A_QUAD,
+
+	PS2000A_MAX_INDEX_MODES
+} PS2000A_INDEX_MODE;
+
+/// <summary>
+/// The number of thershold that will be used for triggering.
+/// </summary>
+typedef enum enPS2000A_ThresholdMode
+{
+	PS2000A_LEVEL,
+	PS2000A_WINDOW
+} PS2000A_THRESHOLD_MODE;
+
+/// <summary>
+/// The direction that the signal will pass through the trigger.
+/// </summary>
+typedef enum enPS2000AThresholdDirection
+{
+	/// <summary>
+	/// For gated triggers: above the upper threshold.
+	/// </summary>
+	PS2000A_ABOVE,
+	/// <summary>
+	/// For gated triggers: below the upper threshold.
+	/// </summary
+	PS2000A_BELOW,
+	/// <summary>
+	/// For threshold triggers: rising edge, using upper threshold.
+	/// </summary>
+	PS2000A_RISING,
+	/// <summary>
+	/// For threshold triggers: falling edge, using upper threshold.
+	/// </summary>
+	PS2000A_FALLING,
+	/// <summary>
+	/// For threshold triggers: either edge.
+	/// </summary>
+	PS2000A_RISING_OR_FALLING,
+	/// <summary>
+	/// For gated triggers: above the lower threshold.
+	/// </summary>
+	PS2000A_ABOVE_LOWER,
+	/// <summary>
+	/// For gated triggers: below the lower threshold.
+	/// </summary>
+	PS2000A_BELOW_LOWER,
+	/// <summary>
+	/// For threshold triggers: rising edge, using lower threshold.
+	/// </summary>
+	PS2000A_RISING_LOWER,
+	/// <summary>
+	/// For threshold triggers: falling edge, using lower threshold.
+	/// </summary>
+	PS2000A_FALLING_LOWER,
+
+	/// <summary>
+	/// For window-qualified triggers: inside window.
+	/// </summary>
+	PS2000A_INSIDE = PS2000A_ABOVE,
+	/// <summary>
+	/// For window-qualified triggers: outside window.
+	/// </summary>
+	PS2000A_OUTSIDE = PS2000A_BELOW,
+	/// <summary>
+	/// For window triggers: entering the window.
+	/// </summary>
+	PS2000A_ENTER = PS2000A_RISING,
+	/// <summary>
+  /// For window triggers: leaving the window.
+  /// </summary>
+	PS2000A_EXIT = PS2000A_FALLING,
+	/// <summary>
+	/// For window triggers: either entering or leaving the window.
+	/// </summary>
+	PS2000A_ENTER_OR_EXIT = PS2000A_RISING_OR_FALLING,
+	/// <summary>
+	/// For window-qualified triggers.
+	/// </summary>
+	PS2000A_POSITIVE_RUNT = 9,
+	/// <summary>
+	/// For window-qualified triggers.
+	/// </summary>
+  PS2000A_NEGATIVE_RUNT,
+
+	/// <summary>
+	/// No trigger.
+	/// </summary>
+  PS2000A_NONE = PS2000A_RISING
+} PS2000A_THRESHOLD_DIRECTION;
+
+
+/// <summary>
+/// Digital channel trigger dirction
+/// </summary>
+typedef enum enPS2000ADigitalDirection
+{
+	PS2000A_DIGITAL_DONT_CARE,
+	PS2000A_DIGITAL_DIRECTION_LOW,
+	PS2000A_DIGITAL_DIRECTION_HIGH,
+	PS2000A_DIGITAL_DIRECTION_RISING,
+	PS2000A_DIGITAL_DIRECTION_FALLING,
+	PS2000A_DIGITAL_DIRECTION_RISING_OR_FALLING,
+	PS2000A_DIGITAL_MAX_DIRECTION
+} PS2000A_DIGITAL_DIRECTION;
+
+/// <summary>
+/// The type of condition that should be applied to each channel.
+/// The channels that are set to True or False must all meet their conditions
+/// simultaneously to produce a trigger. Channels set to DontCare are ignored.
+/// </summary>
+typedef enum enPS2000ATriggerState
+{
+  PS2000A_CONDITION_DONT_CARE,
+  PS2000A_CONDITION_TRUE,
+  PS2000A_CONDITION_FALSE,
+	PS2000A_CONDITION_MAX
+} PS2000A_TRIGGER_STATE;
+
+/// <summary>
+/// A structure of this type is passed to ps2000aSetTriggerChannelConditions in the
+/// conditions argument to specify the trigger conditions.
+/// </summary>
+#pragma pack(push,1)
+typedef struct tPS2000ATriggerConditions
+{
+  PS2000A_TRIGGER_STATE channelA;
+  PS2000A_TRIGGER_STATE channelB;
+  PS2000A_TRIGGER_STATE channelC;
+  PS2000A_TRIGGER_STATE channelD;
+  PS2000A_TRIGGER_STATE external;
+  PS2000A_TRIGGER_STATE aux;
+	PS2000A_TRIGGER_STATE pulseWidthQualifier;
+	PS2000A_TRIGGER_STATE digital;
+} PS2000A_TRIGGER_CONDITIONS;
+#pragma pack(pop)
+
+
+/// <summary>
+/// A structure of this type is passed to ps2000aSetPulseWidthQualifier in the
+/// conditions argument to specify the trigger conditions.
+/// Analog-input models only ( for MSOs use PwqConditionsV2)
+/// </summary>
+#pragma pack(push,1)
+typedef struct tPS2000APwqConditions
+{
+  PS2000A_TRIGGER_STATE channelA;
+  PS2000A_TRIGGER_STATE channelB;
+  PS2000A_TRIGGER_STATE channelC;
+  PS2000A_TRIGGER_STATE channelD;
+  PS2000A_TRIGGER_STATE external;
+  PS2000A_TRIGGER_STATE aux;
+	PS2000A_TRIGGER_STATE digital;
+} PS2000A_PWQ_CONDITIONS;
+#pragma pack(pop)
+
+/// <summary>
+/// A structure of this type is passed to ps2000aSetTriggerChannelDirections in
+/// the directions argument to specify the trigger direction for a specified source.
+/// Not all driver series support this method.
+/// </summary>
+#pragma pack(push,1)
+typedef struct tPS2000ADigitalChannelDirections
+{
+	/// <summary>
+	/// The channel being configured. Channels supported by series SetChannel for allowable values.
+	/// </summary>
+	PS2000A_DIGITAL_CHANNEL channel;
+	/// <summary>
+	/// The trigger direction that should be applied to each channel.
+	/// </summary>
+	PS2000A_DIGITAL_DIRECTION direction;
+} PS2000A_DIGITAL_CHANNEL_DIRECTIONS;
+#pragma pack(pop)
+
+/// <summary>
+/// A structure of this type is passed to ps2000aSetTriggerChannelProperties in the
+/// channelProperties argument to specify the trigger mechanism.
+/// All values are scaled in 16-bit ADC counts at the currently selected range for that channel.
+/// </summary>
+#pragma pack(push,1)
+typedef struct tPS2000ATriggerChannelProperties
+{
+	/// <summary>
+	/// The upper threshold at which the trigger must fire
+	/// </summary>
+  int16_t										thresholdUpper;
+	/// <summary>
+	/// The hysteresis by which the trigger must exceed the upper threshold before it will fire.
+	/// </summary>
+	uint16_t					thresholdUpperHysteresis;
+	/// <summary>
+	/// The lower threshold at which the trigger must fire.
+	/// </summary>
+  int16_t										thresholdLower;
+	/// <summary>
+	/// The hysteresis by which the trigger must exceed the lower threshold before it will fire.
+	/// </summary>
+	uint16_t					thresholdLowerHysteresis;
+	/// <summary>
+	/// The channel to which the properties apply
+	/// </summary>
+	PS2000A_CHANNEL					channel;
+	/// <summary>
+	/// Either a level or window trigger
+	/// </summary>
+  PS2000A_THRESHOLD_MODE	thresholdMode;
+} PS2000A_TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack(pop)
+
+/// <summary>
+/// Various methods of data reduction.
+/// Note that a single call to setting the buffers (ie. ps2000aSetDataBuffer) can only
+/// associate one buffer with one downsampling mode. If you intend to retrieve more than one
+/// downsampling mode from the get values functions, you must call set data buffer several
+///	times to associate a separate buffer with each channel and downsampling mode.
+/// </summary>
+typedef enum enPS2000ARatioMode
+{
+	/// <summary>
+	/// No downsampling. Returns the raw data values.
+	/// </summary>
+	PS2000A_RATIO_MODE_NONE,
+	/// <summary>
+	/// Reduces every block of n values to just two values: a minimum and a maximum.
+	/// The minimum and maximum values are returned in two separate buffers.
+	/// </summary>
+	PS2000A_RATIO_MODE_AGGREGATE = 1,
+	/// <summary>
+	/// Reduces every block of n values to a single value representing the
+	/// average (arithmetic mean) of all the values.
+	/// </summary>
+	PS2000A_RATIO_MODE_DECIMATE = 2,
+	/// <summary>
+	/// Reduces every block of n values to just the first value in the block,
+	/// discarding all the other values.
+	/// </summary>
+	PS2000A_RATIO_MODE_AVERAGE = 4,
+} PS2000A_RATIO_MODE;
+
+
+/// <summary>
+/// The pulse-width type.
+/// </summary>
+typedef enum enPS2000APulseWidthType
+{
+	/// <summary>
+	/// Do not use the pulse width qualifier
+	/// </summary>
+	PS2000A_PW_TYPE_NONE,
+	/// <summary>
+	/// Pulse width less than lower pulse width counter
+	/// </summary>
+  PS2000A_PW_TYPE_LESS_THAN,
+	/// <summary>
+	/// Pulse width greater than lower pulse width counter
+	/// </summary>
+	PS2000A_PW_TYPE_GREATER_THAN,
+	/// <summary>
+	/// Pulse width between lower and upper pulsee width counter
+	/// </summary>
+	PS2000A_PW_TYPE_IN_RANGE,
+	/// <summary>
+	/// Pulse width not between lower and upper pulse width counter
+	/// </summary>
+	PS2000A_PW_TYPE_OUT_OF_RANGE
+} PS2000A_PULSE_WIDTH_TYPE;
+
+typedef enum enPS2000AHoldOffType
+{
+	PS2000A_TIME,
+	PS2000A_MAX_HOLDOFF_TYPE
+} PS2000A_HOLDOFF_TYPE;
+
+#pragma pack(push,1)
+typedef struct tPS2000AScalingFactors
+{
+	PS2000A_CHANNEL channelOrPort;
+	PS2000A_RANGE   range;
+	int16_t         offset;
+	double          scalingFactor;
+}PS2000A_SCALING_FACTORS_VALUES;
+#pragma pack(pop)
+
+  /// <summary>
+  /// This callback function is part of your application. You register it with the ps3000a
+  /// driver using series RunBlock, and the driver calls it back when block-mode data is
+  /// ready. You can then download the data using series GetValues.
+  /// </summary>
+  /// <param name="handle">Device identifier returned by OpenUnit.</param>
+  /// <param name="status">Indicates whether an error occurred during collection of the data.</param>
+  /// <param name="pParameter">A void pointer passed from series RunBlock. Your callback function can write to this
+  ///  location to send any data, such as a status flag, back to your application.</param>
+typedef void (__stdcall *ps2000aBlockReady)
+	(
+		int16_t											handle,
+		PICO_STATUS								status,
+		void										*	pParameter
+	);
+
+/// <summary>
+/// This callback function is part of your application. You register it with the driver using
+/// series GetStreamingLatestValues, and the driver calls it back when streaming- mode data is
+/// ready. You can then download the data using the series GetValuesAsync function.
+/// </summary>
+/// <param name="handle">Device identifier returned by OpenUnit.</param>
+/// <param name="noOfSamples">The number of samples available.</param>
+/// <param name="startIndex">An index to the first valid sample in the buffer. This is
+///  the buffer that was previously passed to series SetDataBuffer.</param>
+/// <param name="overflow">Returns a set of flags that indicate whether an overvoltage has occurred
+///  on any of the channels.It is a bit pattern with bit 0 denoting Channel.</param>
+/// <param name="triggerAt">An index to the buffer indicating the location of the trigger point relative
+///  to startIndex.This parameter is valid only when triggered is non-zero.</param>
+/// <param name="triggered">A flag indicating whether a trigger occurred. If non-zero,
+///  a trigger occurred at the location indicated by triggerAt.</param>
+/// <param name="autoStop">The flag that was set in the call to series RunStreaming.</param>
+/// <param name="pParameter">a void pointer passed from series GetStreamingLatestValues.
+/// The callback function can write to this locatio.</param>
+typedef void (__stdcall *ps2000aStreamingReady)
+	(
+		int16_t    									handle,
+		int32_t     									noOfSamples,
+		uint32_t							startIndex,
+		int16_t    									overflow,
+		uint32_t							triggerAt,
+		int16_t    									triggered,
+		int16_t    									autoStop,
+		void										*	pParameter
+	);
+
+/// <summary>
+/// This is a callback function that you write to collect data from the driver. You supply a
+/// pointer to the function when you call ps3000aGetValuesAsync, and the driver calls
+/// your function back when the data is ready.
+/// </summary>
+/// <param name="handle">Device identifier returned by OpenUnit.</param>
+/// <param name="status">Indicates whether an error occurred during collection of the data.</param>
+/// <param name="noOfSamples">the number of samples collected.</param>
+/// <param name="overflow">A set of flags that indicates whether an overvoltage has
+/// occurred and on which channels.It is a bit field with bit 0 representing Channel A.</param>
+/// <param name="pParameter">A void pointer passed from ps3000aGetValuesAsync. The callback function can
+/// write to this location to send any data, such as a status flag, back to the application.
+/// The data type is defined by the application programmer.</param>
+typedef void (__stdcall *ps2000aDataReady)
+	(
+		int16_t    									handle,
+		PICO_STATUS								status,
+		uint32_t     				noOfSamples,
+		int16_t    									overflow,
+		void										*	pParameter
+	);
+
+/// <summary>
+/// This function opens a PicoScope 2000 Series (A API) scope attached to the computer.
+/// The maximum number of units that can be opened depends on the operating system, the kernel driver and the computer.
+/// </summary>
+/// <param name="handle"> on exit, the result of the attempt to open a scope:
+///                       -1 : if the scope fails to open
+///                       0 : if no scope is found
+///                       > 0 : a number that uniquely identifies the scope
+///                       If a valid handle is returned, it must be used in all subsequent calls
+///												to API functions to identify this scope.</param>
+/// <param name="serial">on entry, a null-terminated string containing the serial
+///                      number of the scope to be opened.If serial is NULL then the
+///                      function opens the first scope found; otherwise, it tries to open the
+///                      scope that matches the string.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_OS_NOT_SUPPORTED
+/// PICO_OPEN_OPERATION_IN_PROGRESS
+/// PICO_EEPROM_CORRUPT
+/// PICO_KERNEL_DRIVER_TOO_OLD
+/// PICO_FPGA_FAIL
+/// PICO_MEMORY_CLOCK_FREQUENCY
+/// PICO_FW_FAIL
+/// PICO_MAX_UNITS_OPENED
+/// PICO_NOT_FOUND(if the specified unit was not found)
+/// PICO_NOT_RESPONDING
+/// PICO_MEMORY_FAIL
+/// PICO_ANALOG_BOARD
+/// PICO_CONFIG_FAIL_AWG
+/// PICO_INITIALISE_FPGA
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aOpenUnit)
+  (
+	  int16_t											* handle,
+		int8_t											* serial
+	);
+
+/// <summary>
+/// This function opens a scope without blocking the calling thread. You can find out when
+/// it has finished by periodically calling ps2000aOpenUnitProgress until that function
+/// returns a non - zero value.
+/// </summary>
+/// <param name="status">a status code:
+///                      0 if the open operation was disallowed because another open
+///                      operation is in progress. 1 if the open operation was successfully.</param>
+/// <param name="serial">see ps2000aOpenUnit.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_OPEN_OPERATION_IN_PROGRESS
+/// PICO_OPERATION_FAILED
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aOpenUnitAsync)
+  (
+	  int16_t											* status,
+		int8_t											* serial
+	);
+
+/// <summary>
+/// This function checks on the progress of a request made to ps2000aOpenUnitAsync to
+/// open a scope.
+/// </summary>
+/// <param name="handle">This handle is valid only if the function returns PICO_OK.</param>
+/// <param name="progressPercent">On exit, the percentage progress towards
+///  opening the scope. 100% implies that the open operation is complete.</param>
+/// <param name="complete">Set to 1 when the open operation has finished.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_NULL_PARAMETER
+/// PICO_OPERATION_FAILED
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aOpenUnitProgress)
+	(
+	  int16_t 										* handle,
+	  int16_t 										* progressPercent,
+	  int16_t 										* complete
+	);
+
+/// <summary>
+/// This function retrieves information about the specified oscilloscope. If the device fails
+/// to open, or no device is opened only the driver version is available.
+/// </summary>
+/// <param name="handle">device identifier returned by ps2000aOpenUnit. If an invalid
+///  handle is passed, only the driver versions can be read.</param>
+/// <param name="string">On exit, the unit information string selected specified by
+/// the info argument.If string is NULL, only requiredSize is returned.</param>
+/// <param name="stringLength">The maximum number of chars that may be written to string.</param>
+/// <param name="requiredSize">On exit, the required length of the string array.</param>
+/// <param name="info">a number specifying what information is required.
+/// The possible values are listed in the table below.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_INVALID_HANDLE
+/// PICO_NULL_PARAMETER
+/// PICO_INVALID_INFO
+/// PICO_INFO_UNAVAILABLE
+/// PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetUnitInfo)
+ 	(
+	  int16_t     								  handle,
+	  int8_t      								* string,
+	  int16_t     								  stringLength,
+	  int16_t     								* requiredSize,
+	  PICO_INFO 								  info
+	);
+
+/// <summary>
+/// This function flashes the LED on the front of the scope without blocking the calling
+/// thread.Calls to ps2000aRunStreaming and ps2000aRunBlock cancel any flashing
+/// started by this function.It is not possible to set the LED to be constantly illuminated,
+///  as this state is used to indicate that the scope has not been initialized.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="start">the action required:
+///            < 0 : flash the LED indefinitely
+///            0 : stop the LED flashing
+///            > 0 : flash the LED start times.If the LED is already flashing
+///                  on entry to this function, the flash count will be reset to start.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_HANDLE_INVALID
+///	PICO_BUSY
+///	PICO_DRIVER_FUNCTION
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aFlashLed)
+	(
+	  int16_t 											handle,
+		int16_t 											start
+	);
+
+/// <summary>
+/// This function shuts down an oscilloscope.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_HANDLE_INVALID
+///	PICO_USER_CALLBACK
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aCloseUnit)
+	(
+	  int16_t												handle
+	);
+
+/// <summary>
+/// This function sets the number of memory segments that the scope will use. When the scope is opened,
+/// the number of segments defaults to 1, meaning that each capture fills the scope's available memory.
+/// This function allows you to divide the memory into a number of segments so that the scope can
+/// store several waveforms sequentially.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="nSegments">The number of segments required, from 1 to ps2000aGetMaxSegments.</param>
+/// <param name="nMaxSamples">on exit, the number of samples available in each segment.This is
+///  the total number over all channels, so if more than one channel is in use then the number
+///  of samples available to each channel is nMaxSamples divided by the number of channels.</param>
+/// <returns>
+///	PICO_OK
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_HANDLE
+///	PICO_TOO_MANY_SEGMENTS
+///	PICO_MEMORY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aMemorySegments)
+	(
+	  int16_t												handle,
+		uint32_t							nSegments,
+		int32_t											* nMaxSamples
+	);
+
+/// <summary>
+/// This function specifies whether an input channel is to be enabled, its input coupling
+///	type, voltage range, analog offset.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="channel">, the channel to be configured. The values are:
+///		PS2000A_CHANNEL_A: Channel A input
+///		PS2000A_CHANNEL_B : Channel B input
+///		PS2000A_CHANNEL_C : Channel C input
+///		PS2000A_CHANNEL_D : Channel D input</param>
+/// <param name="enabled">Whether or not to enable the channel. The values are:
+///		TRUE: enable
+///		FALSE : do not enable</param>
+/// <param name="type">the impedance and coupling type. The values are:
+///		PS2000A_AC: 1 megohm impedance, AC coupling.The channel accepts input frequencies
+///               from about 1 hertz up to its maximum analog bandwidth.
+///		PS2000A_DC: 1 megohm impedance, DC coupling.The channel accepts all input frequencies
+///               from zero(DC) up to its maximum analog bandwidth.</param>
+/// <param name="range">The input voltage range.</param>
+/// <param name="analogOffset">a voltage to add to the input channel before digitization.
+/// The allowable range of offsets can be obtained from ps2000aGetAnalogueOffset and depends
+/// on the input range selected for the channel.This argument is ignored if the device is a
+/// PicoScope 2205 MSO.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_VOLTAGE_RANGE
+///	PICO_INVALID_COUPLING
+///	PICO_INVALID_ANALOGUE_OFFSET
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetChannel)
+ 	(
+	  int16_t												handle,
+		PS2000A_CHANNEL							channel,
+	  int16_t												enabled,
+	  PS2000A_COUPLING						type,
+		PS2000A_RANGE								range,
+		float												analogOffset
+	);
+
+/// <summary>
+/// This function is used to enable the digital ports of an MSO and set the logic level (the
+///	voltage point at which the state transitions from 0 to 1).
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="port">the digital port to be configured:
+///		PS2000A_DIGITAL_PORT0 = 0x80 (D0 to D7)
+///		PS2000A_DIGITAL_PORT1 = 0x81 (D8 to D15)</param>
+/// <param name="enabled">Whether or not to enable the channel. The values are:
+///		TRUE: enable
+///		FALSE : do not enable</param>
+/// <param name="logicLevel">The logic threshold voltage. Range: �32767 (�5 V) to 32767 (5 V).</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_CHANNEL
+///	PICO_RATIO_MODE_NOT_SUPPORTED
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetDigitalPort)
+ 	(
+	  int16_t												handle,
+		PS2000A_DIGITAL_PORT				port,
+	  int16_t												enabled,
+		int16_t									      logicLevel
+	);
+
+
+/// <summary>
+/// This function sets the number of captures to be collected in one run of rapid block
+///	mode.If you do not call this function before a run, the driver will capture only one
+///	waveform.Once a value has been set, the value remains constant unless changed.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="nCaptures">The number of waveforms to capture in one run.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetNoOfCaptures)
+	(
+	int16_t handle,
+	uint32_t nCaptures
+	);
+
+/// <summary>
+/// This function calculates the sampling rate and maximum number of samples for a
+/// given timebase under the specified conditions.The result will depend on the number of
+/// channels enabled by the last call to ps2000aSetChannel.
+///
+/// This function is provided for use with programming languages that do not support the
+/// float data type.The value returned in the timeIntervalNanoseconds argument is
+/// restricted to integers.If your programming language supports the float type, we
+/// recommend that you use ps2000aGetTimebase2 instead.
+///
+/// To use ps2000aGetTimebase or ps2000aGetTimebase2, first estimate the timebase
+/// number that you require using the information in the timebase guide.Next, call one of
+/// these functions with the timebase that you have just chosen and verify that the
+/// timeIntervalNanoseconds argument that the function returns is the value that you
+/// require.You may need to iterate this process until you obtain the time interval that you need.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="timebase">The timebase guide.</param>
+/// <param name="noSamples">The number of samples required.</param>
+/// <param name="timeIntervalNanoseconds">On exit, the time interval between readings at the
+///  selected timebase.Use NULL if not required.In ETS mode this argument is not valid;
+///  use the sample time returned by ps2000aSetEts.</param>
+/// <param name="oversample">Not used.</param>
+/// <param name="maxSamples">On exit, the maximum number of samples available. The scope allocates
+/// a certain amount of memory for internal overheads and this may vary depending on the number of
+///  segments, number of channels enabled, and the timebase chosen.Use NULL if not required.</param>
+/// <param name="segmentIndex">The index of the memory segment to use.</param>
+/// <returns>
+/// /// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_TOO_MANY_SAMPLES
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_TIMEBASE
+///	PICO_INVALID_PARAMETER
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetTimebase)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   int32_t											* timeIntervalNanoseconds,
+	   int16_t											oversample,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+/// <summary>
+/// This function is an upgraded version of ps2000aGetTimebase, and returns the time
+///	interval as a float rather than a long.This allows it to return sub - nanosecond time
+///	intervals.See ps2000aGetTimebase for a full description.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="timebase">The timebase guide.</param>
+/// <param name="noSamples">The number of samples required.</param>
+/// <param name="timeIntervalNanoseconds">A pointer to the time interval between readings at
+///  the selected timebase.If a null pointer is passed, the parameter will be ignored.</param>
+/// <param name="oversample">Not used.</param>
+/// <param name="maxSamples">On exit, the maximum number of samples available. The scope allocates
+/// a certain amount of memory for internal overheads and this may vary depending on the number of
+///  segments, number of channels enabled, and the timebase chosen.Use NULL if not required.</param>
+/// <param name="segmentIndex">The index of the memory segment to use.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_TOO_MANY_SAMPLES
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_TIMEBASE
+///	PICO_INVALID_PARAMETER
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetTimebase2)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   float										* timeIntervalNanoseconds,
+	   int16_t											oversample,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+/// <summary>
+/// This function programs the signal generator to produce an arbitrary waveform. The arbitrary waveform
+/// generator uses direct digital synthesis (DDS). It maintains a 32 - bit phase accumulator that
+/// indicates the present location in the waveform.The top bits of the phase accumulator are used as
+/// an index into a buffer containing the arbitrary waveform.The remaining bits act as the fractional
+/// part of the index, enabling high - resolution control of output frequency and allowing the
+/// generation of lower frequencies.
+///
+/// The phase accumulator initially increments by startDeltaPhase.If the AWG is set to sweep mode, the
+/// phase increment is increased at specified intervals until it reaches stopDeltaPhase. The easiest way
+/// to obtain the values of startDeltaPhase and stopDeltaPhase necessary to generate the desired frequency
+/// is to call ps2000aSigGenFrequencyToPhase.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="offsetVoltage">The voltage offset, in microvolts, to be applied to the waveform.</param>
+/// <param name="pkToPk">The peak-to-peak voltage, in microvolts, of the waveform signal.</param>
+/// <param name="startDeltaPhase">The initial value added to the phase accumulator as the generator
+///	begins to step through the waveform buffer.Calculate this value from the information above, or use
+/// ps2000aSigGenFrequencyToPhase.</param>
+/// <param name="stopDeltaPhase">The final value added to the phase accumulator before the generator
+/// restarts or reverses the sweep.When frequency sweeping is not required, set equal to startDeltaPhase.</param>
+/// <param name="deltaPhaseIncrement">the amount added to the delta phase value every time the dwellCount
+/// period expires.This determines the amount by which the generator sweeps the output frequency in each
+/// dwell period.When frequency sweeping is not required, set to zero.</param>
+/// <param name="dwellCount">the time, in multiples of ddsPeriod, between successive additions of
+///	deltaPhaseIncrement to the delta phase accumulator.This determines the rate at which the generator
+/// sweeps the output frequency.Minimum value : PS2000A_MIN_DWELL_COUNT.</param>
+/// <param name="arbitaryWaveform">A buffer that holds the waveform pattern as a set of samples equally
+/// spaced in time.Each sample is scaled to an output voltage as follows:
+///
+///    vOUT = 1 �V *(pkToPk / 2) *(sample_value / 32767) + offsetVoltage
+///
+/// and clipped to the overall �2 V range of the AWG.</param>
+/// <param name="arbitaryWaveformSize">the size of the arbitrary waveform buffer, in samples, in the range:
+/// [minArbitraryWaveformSize, maxArbitraryWaveformSize] where minArbitraryWaveformSize and
+/// maxArbitraryWaveformSize are the values returned by ps2000aSigGenArbitraryMinMaxValues.</param>
+/// <param name="sweepType">, determines whether the startDeltaPhase is swept up to the stopDeltaPhase,
+/// or down to it, or repeatedly swept up and down.</param>
+/// <param name="operation">The type of waveform to be produced.</param>
+/// <param name="indexMode">Specifies how the signal will be formed from the arbitrary waveform data.
+/// Single and dual index modes are possible.</param>
+/// <param name="shots">0: sweep the frequency as specified by sweeps
+///	1...PS2000A_MAX_SWEEPS_SHOTS: the number of cycles of the waveform to be
+/// produced after a trigger event.sweeps must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN : start and run continuously after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="sweeps">0: produce number of cycles specified by shots
+/// 1..PS2000A_MAX_SWEEPS_SHOTS: the number of times to sweep the frequency after a trigger event,
+/// according to sweepType.shots must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN: start a sweep and continue after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="triggerType">The type of trigger that will be applied to the signal generator.</param>
+/// <param name="triggerSource">The source that will trigger the signal generator.
+/// If a trigger source other than P2000A_SIGGEN_NONE is specified, then either shots or sweeps,
+/// but not both, must be non - zero.</param>
+/// <param name="extInThreshold">Trigger level, in ADC counts, for external trigger.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_AWG_NOT_SUPPORTED
+///	PICO_BUSY
+///	PICO_INVALID_HANDLE
+///	PICO_SIG_GEN_PARAM
+///	PICO_SHOTS_SWEEPS_WARNING
+///	PICO_NOT_RESPONDING
+///	PICO_WARNING_EXT_THRESHOLD_CONFLICT
+///	PICO_NO_SIGNAL_GENERATOR
+///	PICO_SIGGEN_OFFSET_VOLTAGE
+///	PICO_SIGGEN_PK_TO_PK
+///	PICO_SIGGEN_OUTPUT_OVER_VOLTAGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_SIGGEN_WAVEFORM_SETUP_FAILED
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetSigGenArbitrary)
+	(
+	 	int16_t												handle,
+	 	int32_t												offsetVoltage,
+	 	uint32_t								pkToPk,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+	 	int16_t											*	arbitraryWaveform,
+	 	int32_t												arbitraryWaveformSize,
+		PS2000A_SWEEP_TYPE					sweepType,
+		PS2000A_EXTRA_OPERATIONS		operation,
+		PS2000A_INDEX_MODE					indexMode,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS2000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS2000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+/// <summary>
+/// This function sets up the signal generator to produce a signal from a list of built-in
+/// waveforms.If different start and stop frequencies are specified, the device will sweep
+/// either up, down, or up and down.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="offsetVoltage">The voltage offset, in microvolts, to be applied to the waveform</param>
+/// <param name="pkToPk">The peak-to-peak voltage, in microvolts, of the waveform signal.
+///
+///  Note: if the signal voltages described by the combination of offsetVoltage and pkToPk
+///  extend outside the voltage range of the signal generator, the output waveform will be clipped.</param>
+/// <param name="waveType">The type of waveform to be generated.</param>
+/// <param name="startFrequency">The frequency that the signal generator will initially produce. See
+/// #defines above.</param>
+/// <param name="stopFrequency">The frequency at which the sweep reverses direction or returns to
+///	the initial frequency.</param>
+/// <param name="increment">The amount of frequency increase or decrease in sweep mode.</param>
+/// <param name="dwellTime">The time for which the sweep stays at each frequency, in seconds.</param>
+/// <param name="sweepType">whether the frequency will sweep from startFrequency to stopFrequency,
+///  or in the opposite direction, or repeatedly reverse direction.</param>
+/// <param name="operation">the type of waveform to be produced, specified by one of the following
+///	enumerated types :
+///		PS2000A_ES_OFF, normal signal generator operation specified by waveType.PS2000A_WHITENOISE,
+///	  the signal generator produces white noise and ignores all settings except pkToPk and offsetVoltage.
+///		PS2000A_PRBS, produces a random bitstream with a bit rate specified by the start and stop
+///		frequency(not available on PicoScope 2205 MSO).</param>
+/// <param name="shots">0: sweep the frequency as specified by sweeps
+///	1...PS2000A_MAX_SWEEPS_SHOTS: the number of cycles of the waveform to be
+/// produced after a trigger event.sweeps must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN : start and run continuously after trigger
+/// occurs(not PicoScope 2205 MSO)./param>
+/// <param name="sweeps">0: produce number of cycles specified by shots
+/// 1..PS2000A_MAX_SWEEPS_SHOTS: the number of times to sweep the frequency after a trigger event,
+/// according to sweepType.shots must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN: start a sweep and continue after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="triggerType">The type of trigger that will be applied to the signal generator.</param>
+/// <param name="triggerSource">The source that will trigger the signal generator.
+/// If a trigger source other than P2000A_SIGGEN_NONE is specified, then either shots or sweeps,
+/// but not both, must be non - zero.</param>
+/// <param name="extInThreshold">Trigger level, in ADC counts, for external trigger.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_BUSY
+///	PICO_INVALID_HANDLE
+///	PICO_SIG_GEN_PARAM
+///	PICO_SHOTS_SWEEPS_WARNING
+///	PICO_NOT_RESPONDING
+///	PICO_WARNING_AUX_OUTPUT_CONFLICT
+///	PICO_WARNING_EXT_THRESHOLD_CONFLICT
+///	PICO_NO_SIGNAL_GENERATOR
+///	PICO_SIGGEN_OFFSET_VOLTAGE
+///	PICO_SIGGEN_PK_TO_PK
+///	PICO_SIGGEN_OUTPUT_OVER_VOLTAGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_SIGGEN_WAVEFORM_SETUP_FAILED
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSetSigGenBuiltIn)
+	(
+		int16_t												handle,
+		int32_t												offsetVoltage,
+		uint32_t								pkToPk,
+		int16_t												waveType,
+		float												startFrequency,
+		float												stopFrequency,
+		float												increment,
+		float												dwellTime,
+		PS2000A_SWEEP_TYPE					sweepType,
+		PS2000A_EXTRA_OPERATIONS		operation,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS2000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS2000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+		);
+
+/// <summary>
+/// This function sets up the signal generator. It differs from ps2000SetSigGenBuiltIn in
+/// having double - precision arguments instead of floats, giving greater resolution when
+/// setting the output frequency.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="offsetVoltage">The voltage offset, in microvolts, to be applied to the waveform.</param>
+/// <param name="pkToPk">The peak-to-peak voltage, in microvolts, of the waveform signal.
+///
+///  Note: if the signal voltages described by the combination of offsetVoltage and pkToPk
+///  extend outside the voltage range of the signal generator, the output waveform will be clipped.</param>
+/// <param name="waveType">The type of waveform to be generated.</param>
+/// <param name="startFrequency">The frequency that the signal generator will initially produce. See
+/// #defines above.</param>
+/// <param name="stopFrequency">The frequency at which the sweep reverses direction or returns to
+///	the initial frequency.</param>
+/// <param name="increment">The amount of frequency increase or decrease in sweep mode.</param>
+/// <param name="dwellTime">The time for which the sweep stays at each frequency, in seconds.</param>
+/// <param name="sweepType">whether the frequency will sweep from startFrequency to stopFrequency,
+///  or in the opposite direction, or repeatedly reverse direction.</param>
+/// <param name="operation">the type of waveform to be produced, specified by one of the following
+///	enumerated types :
+///		PS2000A_ES_OFF, normal signal generator operation specified by waveType.PS2000A_WHITENOISE,
+///	  the signal generator produces white noise and ignores all settings except pkToPk and offsetVoltage.
+///		PS2000A_PRBS, produces a random bitstream with a bit rate specified by the start and stop
+///		frequency(not available on PicoScope 2205 MSO).</param>
+/// <param name="shots">0: sweep the frequency as specified by sweeps
+///	1...PS2000A_MAX_SWEEPS_SHOTS: the number of cycles of the waveform to be
+/// produced after a trigger event.sweeps must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN : start and run continuously after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="sweeps">0: produce number of cycles specified by shots
+/// 1..PS2000A_MAX_SWEEPS_SHOTS: the number of times to sweep the frequency after a trigger event,
+/// according to sweepType.shots must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN: start a sweep and continue after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="triggerType">The type of trigger that will be applied to the signal generator.</param>
+/// <param name="triggerSource">The source that will trigger the signal generator.
+/// If a trigger source other than P2000A_SIGGEN_NONE is specified, then either shots or sweeps,
+/// but not both, must be non - zero.</param>
+/// <param name="extInThreshold">Trigger level, in ADC counts, for external trigger.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_BUSY
+///	PICO_INVALID_HANDLE
+///	PICO_SIG_GEN_PARAM
+///	PICO_SHOTS_SWEEPS_WARNING
+///	PICO_NOT_RESPONDING
+///	PICO_WARNING_AUX_OUTPUT_CONFLICT
+///	PICO_WARNING_EXT_THRESHOLD_CONFLICT
+///	PICO_NO_SIGNAL_GENERATOR
+///	PICO_SIGGEN_OFFSET_VOLTAGE
+///	PICO_SIGGEN_PK_TO_PK
+///	PICO_SIGGEN_OUTPUT_OVER_VOLTAGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_SIGGEN_WAVEFORM_SETUP_FAILED
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSetSigGenBuiltInV2)
+	(
+		int16_t												handle,
+		int32_t												offsetVoltage,
+		uint32_t								pkToPk,
+		int16_t												waveType,
+		double												startFrequency,
+		double												stopFrequency,
+		double												increment,
+		double												dwellTime,
+		PS2000A_SWEEP_TYPE					sweepType,
+		PS2000A_EXTRA_OPERATIONS		operation,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS2000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS2000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+		);
+
+/// <summary>
+/// This function reprograms the arbitrary waveform generator. All values can be reprogrammed while
+/// the signal generator is waiting for a trigger.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startDeltaPhase">The initial value added to the phase accumulator as the generator
+///	begins to step through the waveform buffer.Calculate this value from the information above, or use
+/// ps2000aSigGenFrequencyToPhase.</param>
+/// <param name="stopDeltaPhase">The final value added to the phase accumulator before the generator
+/// restarts or reverses the sweep.When frequency sweeping is not required, set equal to startDeltaPhase.</param>
+/// <param name="deltaPhaseIncrement">the amount added to the delta phase value every time the dwellCount
+/// period expires.This determines the amount by which the generator sweeps the output frequency in each
+/// dwell period.When frequency sweeping is not required, set to zero.</param>
+/// <param name="dwellCount">the time, in multiples of ddsPeriod, between successive additions of
+///	deltaPhaseIncrement to the delta phase accumulator.This determines the rate at which the generator
+/// sweeps the output frequency.Minimum value : PS2000A_MIN_DWELL_COUNT.</param>
+/// <param name="arbitaryWaveform">A buffer that holds the waveform pattern as a set of samples equally
+/// spaced in time.Each sample is scaled to an output voltage as follows:
+///
+///    vOUT = 1 �V *(pkToPk / 2) *(sample_value / 32767) + offsetVoltage
+///
+/// and clipped to the overall �2 V range of the AWG.</param>
+/// <param name="arbitaryWaveformSize">the size of the arbitrary waveform buffer, in samples, in the range:
+/// [minArbitraryWaveformSize, maxArbitraryWaveformSize] where minArbitraryWaveformSize and
+/// maxArbitraryWaveformSize are the values returned by ps2000aSigGenArbitraryMinMaxValues.</param>
+/// <param name="sweepType">, determines whether the startDeltaPhase is swept up to the stopDeltaPhase,
+/// or down to it, or repeatedly swept up and down.</param>
+/// <param name="operation">The type of waveform to be produced.</param>
+/// <param name="indexMode">Specifies how the signal will be formed from the arbitrary waveform data.
+/// Single and dual index modes are possible.</param>
+/// <param name="shots">0: sweep the frequency as specified by sweeps
+///	1...PS2000A_MAX_SWEEPS_SHOTS: the number of cycles of the waveform to be
+/// produced after a trigger event.sweeps must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN : start and run continuously after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="sweeps">0: produce number of cycles specified by shots
+/// 1..PS2000A_MAX_SWEEPS_SHOTS: the number of times to sweep the frequency after a trigger event,
+/// according to sweepType.shots must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN: start a sweep and continue after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="triggerType">The type of trigger that will be applied to the signal generator.</param>
+/// <param name="triggerSource">The source that will trigger the signal generator.
+/// If a trigger source other than P2000A_SIGGEN_NONE is specified, then either shots or sweeps,
+/// but not both, must be non - zero.</param>
+/// <param name="extInThreshold">Trigger level, in ADC counts, for external trigger.</param>
+/// <returns>
+/// PICO_OK if successful
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SIGNAL_GENERATOR
+///	PICO_DRIVER_FUNCTION
+///	PICO_AWG_NOT_SUPPORTED
+///	PICO_SIGGEN_OFFSET_VOLTAGE
+///	PICO_SIGGEN_PK_TO_PK
+///	PICO_SIGGEN_OUTPUT_OVER_VOLTAGE
+///	PICO_SIG_GEN_PARAM
+///	PICO_SHOTS_SWEEPS_WARNING
+///	PICO_WARNING_EXT_THRESHOLD_CONFLICT
+///	PICO_BUSY
+///	PICO_SIGGEN_WAVEFORM_SETUP_FAILED
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetSigGenPropertiesArbitrary)
+	(
+	 	int16_t												handle,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+		PS2000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS2000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS2000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+/// <summary>
+/// This function reprograms the signal generator. Values can be changed while the signal
+///	generator is waiting for a trigger.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startFrequency">The frequency that the signal generator will initially produce. See
+/// #defines above.</param>
+/// <param name="stopFrequency">The frequency at which the sweep reverses direction or returns to
+///	the initial frequency.</param>
+/// <param name="increment">The amount of frequency increase or decrease in sweep mode.</param>
+/// <param name="dwellTime">The time for which the sweep stays at each frequency, in seconds.</param>
+/// <param name="sweepType">whether the frequency will sweep from startFrequency to stopFrequency,
+///  or in the opposite direction, or repeatedly reverse direction.</param>
+/// <param name="operation">the type of waveform to be produced, specified by one of the following
+///	enumerated types :
+///		PS2000A_ES_OFF, normal signal generator operation specified by waveType.PS2000A_WHITENOISE,
+///	  the signal generator produces white noise and ignores all settings except pkToPk and offsetVoltage.
+///		PS2000A_PRBS, produces a random bitstream with a bit rate specified by the start and stop
+///		frequency(not available on PicoScope 2205 MSO).</param>
+/// <param name="shots">0: sweep the frequency as specified by sweeps
+///	1...PS2000A_MAX_SWEEPS_SHOTS: the number of cycles of the waveform to be
+/// produced after a trigger event.sweeps must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN : start and run continuously after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="sweeps">0: produce number of cycles specified by shots
+/// 1..PS2000A_MAX_SWEEPS_SHOTS: the number of times to sweep the frequency after a trigger event,
+/// according to sweepType.shots must be zero.
+/// PS2000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN: start a sweep and continue after trigger
+/// occurs(not PicoScope 2205 MSO).</param>
+/// <param name="triggerType">The type of trigger that will be applied to the signal generator.</param>
+/// <param name="triggerSource">The source that will trigger the signal generator.
+/// If a trigger source other than P2000A_SIGGEN_NONE is specified, then either shots or sweeps,
+/// but not both, must be non - zero.</param>
+/// <param name="extInThreshold">Trigger level, in ADC counts, for external trigger.</param>
+/// <returns>
+/// PICO_OK if successful
+/// PICO_INVALID_HANDLE
+/// PICO_NO_SIGNAL_GENERATOR
+/// PICO_DRIVER_FUNCTION
+/// PICO_WARNING_EXT_THRESHOLD_CONFLICT
+/// PICO_SIGGEN_OFFSET_VOLTAGE
+/// PICO_SIGGEN_PK_TO_PK
+/// PICO_SIGGEN_OUTPUT_OVER_VOLTAGE
+/// PICO_SIG_GEN_PARAM
+/// PICO_SHOTS_SWEEPS_WARNING
+/// PICO_WARNING_EXT_THRESHOLD_CONFLICT
+/// PICO_BUSY
+/// PICO_SIGGEN_WAVEFORM_SETUP_FAILED
+/// PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSetSigGenPropertiesBuiltIn)
+	(
+		int16_t												handle,
+		double												startFrequency,
+		double												stopFrequency,
+		double												increment,
+		double												dwellTime,
+		PS2000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS2000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS2000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+/// <summary>
+/// This function converts a frequency to a phase count for use with the arbitrary waveform
+///  generator setup functions ps2000aSetSigGenArbitrary and ps2000aSetSigGenPropertiesArbitrary.
+/// The value returned depends on the length of the buffer, the index mode passed and the device model.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="frequency">The required AWG output frequency.</param>
+/// <param name="indexMode">See AWG index modes.</param>
+/// <param name="bufferLength">The number of samples in the AWG buffer.</param>
+/// <param name="phase">On exit, the deltaPhase argument to be sent to the AWG setup function.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_NOT_SUPPORTED_BY_THIS_DEVICE, if the device does not have an AWG.
+///	PICO_SIGGEN_FREQUENCY_OUT_OF_RANGE, if the frequency is out of range.
+///	PICO_NULL_PARAMETER, if phase is a NULL pointer.
+///	PICO_SIG_GEN_PARAM, if indexMode or bufferLength is out of range.
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	PS2000A_INDEX_MODE						indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+/// <summary>
+/// This function returns the range of possible sample values and waveform buffer sizes
+/// that can be supplied to ps2000aSetSigGenArbitrary for setting up the arbitrary
+/// waveform generator(AWG).These values may vary between models.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="minArbitraryWaveformValue">On exit, the lowest sample value allowed in the
+/// arbitraryWaveform buffer supplied to ps2000aSetChannelInfoSigGenArbitrary.</param>
+/// <param name="maxArbitraryWaveformValue">On exit, the highest sample value allowed in the
+///  arbitraryWaveform buffer supplied to ps2000aSetSigGenArbitrary.</param>
+/// <param name="minArbitraryWaveformSize">On exit, the minimum value allowed for the
+/// arbitraryWaveformSize argument supplied to ps2000aSetSigGenArbitrary.</param>
+/// <param name="maxArbitraryWaveformSize">On exit, the maximum value allowed for the
+/// arbitraryWaveformSize argument supplied to ps2000aSetSigGenArbitrary.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_NOT_SUPPORTED_BY_THIS_DEVICE, if the device does not have an arbitrary waveform generator.
+/// PICO_NULL_PARAMETER, if all the parameter pointers are NULL.
+/// PICO_INVALID_HANDLE
+/// PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+/// <summary>
+/// This function causes a trigger event, or starts and stops gating. Use it as follows:
+/// 1. Call ps2000aSetSigGenBuiltIn or ps2000aSetSigGenArbitrary to set up the signal generator,
+/// setting the triggerSource argument to SIGGEN_SOFT_TRIG.
+/// 2. (a)If you set the signal generator triggerType to edge triggering (PS2000A_SIGGEN_RISING or
+/// PS2000A_SIGGEN_FALLING), call ps2000aSigGenSoftwareControl once to trigger a capture.
+/// (b)If you set the signal generator triggerType to gated triggering (PS2000A_SIGGEN_GATE_HIGH
+/// or PS2000A_SIGGEN_GATE_LOW), call ps2000aSigGenSoftwareControl with state set to 0 to start
+/// capture, and then again with state set to 1 to stop capture.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="state">specifies whether to start or stop capture. Effective only when the signal
+/// generator triggerType is set to SIGGEN_GATE_HIGH or SIGGEN_GATE_LOW.Ignored for other trigger types.
+///			0: to start capture
+///			<> 0 : to stop </param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SIGNAL_GENERATOR
+///	PICO_SIGGEN_TRIGGER_SOURCE
+///	PICO_DRIVER_FUNCTION
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSigGenSoftwareControl)
+	(
+		int16_t												handle,
+		int16_t												state
+	);
+
+/// <summary>
+/// This function is used to enable or disable ETS (equivalent-time sampling) and to set
+///	the ETS parameters.See ETS overview for an explanation of ETS mode.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="mode">The ETS mode.</param>
+/// <param name="etsCycles">the number of cycles to store: the computer can then select etsInterleave
+///  cycles to give the most uniform spread of samples.Range: between two and five times the value of
+///  etsInterleave, and not more than the appropriate MAX_ETS_CYCLES constant:
+///	 see #defines above.</param>
+/// <param name="etsInterleave">the number of waveforms to combine into a single ETS capture.
+///	see #defines above for Maximum value.</param>
+/// <param name="sampleTimePicoseconds">on exit, the effective sampling interval of the ETS data.
+/// For example, if the captured sample time is 4 ns and etsInterleave is 10, then the effective
+/// sample time in ETS mode is 400 ps.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetEts)
+  (
+		int16_t												handle,
+		PS2000A_ETS_MODE						mode,
+		int16_t												etsCycles,
+		int16_t												etsInterleave,
+		int32_t											* sampleTimePicoseconds
+	);
+
+/// <summary>
+/// This function simplifies arming the trigger. It supports only the LEVEL trigger types
+/// and does not allow more than one channel to have a trigger applied to it.Any previous
+/// pulse width qualifier is canceled.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="enable">Zero to disable the trigger, any non-zero value to set the trigger.</param>
+/// <param name="source">The channel on which to trigger.</param>
+/// <param name="threshold">The ADC count at which the trigger will fire.</param>
+/// <param name="direction">The direction in which the signal must move to cause a trigger.</param>
+/// <param name="delay">The time between the trigger occurring and the first sample being taken.
+/// For example, if delay = 100 then the scope would wait 100 sample periods before sampling.</param>
+/// <param name="autoTrigger_ms">the number of milliseconds the device will wait if no trigger occurs.
+/// If this is set to zero, the scope device will wait indefinitely for a trigger.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_PARAMETER
+///	PICO_MEMORY
+///	PICO_CONDITIONS
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetSimpleTrigger)
+	(
+		int16_t handle,
+		int16_t enable,
+		PS2000A_CHANNEL source,
+		int16_t threshold,
+		PS2000A_THRESHOLD_DIRECTION direction,
+		uint32_t delay,
+		int16_t autoTrigger_ms
+	);
+
+/// <summary>
+/// This function will set the individual Digital channels trigger directions. Each trigger
+/// direction consists of a channel name and a direction.If the channel is not included in
+/// the array of PS2000A_DIGITAL_CHANNEL_DIRECTIONS the driver assumes the digital
+/// channel's trigger direction is PS2000A_DIGITAL_DONT_CARE.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="directions">a pointer to an array of PS2000A_DIGITAL_CHANNEL_DIRECTIONS
+/// structures describing the requested properties.The array can contain a single element
+/// describing the properties of one channel, or a number of elements describing several
+/// digital channels.If directions is NULL, digital triggering is switched off.A digital
+/// channel that is not included in the array will be set to PS2000A_DIGITAL_DONT_CARE.</param>
+/// <param name="nDirections">The number of digital channel directions being passed to the driver.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_INVALID_HANDLE
+/// PICO_DRIVER_FUNCTION
+/// PICO_INVALID_DIGITAL_CHANNEL
+/// PICO_INVALID_DIGITAL_TRIGGER_DIRECTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetTriggerDigitalPortProperties)
+(
+	int16_t handle,
+	PS2000A_DIGITAL_CHANNEL_DIRECTIONS * directions,
+	int16_t															   nDirections
+);
+
+/// <summary>
+/// Mixed-signal (MSO) models in this series have two independent triggers, one for the
+/// analog input channels and another for the digital inputs.This function defines how the
+/// two triggers are combined.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="operand">How the analogue and digital triggers will interact with each other.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_NOT_USED
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetDigitalAnalogTriggerOperand)
+(
+	int16_t handle,
+	PS2000A_TRIGGER_OPERAND operand
+);
+
+/// <summary>
+/// This function will set the individual digital channels' pulse-width trigger directions.
+///  Each trigger direction consists of a channel name and a direction. If the channel is not
+/// included in the array of PS2000A_DIGITAL_CHANNEL_DIRECTIONS the driver assumes the digital
+/// channel's pulse-width trigger direction is PS2000A_DIGITAL_DONT_CARE.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="directions">A pointer to an array of PS2000A_DIGITAL_CHANNEL_DIRECTIONS structures
+/// describing the requested properties.The array can contain a single element describing the
+/// properties of one channel, or a number of elements describing several digital channels.
+/// If directions is NULL, digital pulse - width triggering is switched off. A digital channel that
+/// is not included in the array will be set to PS2000A_DIGITAL_DONT_CARE.</param>
+/// <param name="nDirections">the number of digital channel directions being passed to the driver.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_DIGITAL_CHANNEL
+///	PICO_INVALID_DIGITAL_TRIGGER_DIRECTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetPulseWidthDigitalPortProperties)
+	(
+	int16_t                               handle,
+	PS2000A_DIGITAL_CHANNEL_DIRECTIONS *directions,
+	int16_t                               nDirections
+	);
+
+
+/// <summary>
+/// This function is used to enable or disable triggering and set its parameters.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="channelProperties">A pointer to an array of PS2000A_TRIGGER_CHANNEL_PROPERTIES
+/// structures describing the requested properties.The array can contain a single element
+///	describing the properties of one channel, or a number of elements describing several channels.
+/// If NULL is passed, triggering is switched off.</param>
+/// <param name="nChannelProperties">The size of the channelProperties array. If zero, triggering
+/// is switched off.</param>
+/// <param name="auxOutputEnable">Not used.</param>
+/// <param name="autoTriggerMilliseconds">The time in milliseconds for which the scope device will
+///  wait before collecting data if no trigger event occurs.If this is set to zero, the scope
+///  device will wait indefinitely for a trigger.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_TRIGGER_ERROR
+///	PICO_MEMORY
+///	PICO_INVALID_TRIGGER_PROPERTY
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetTriggerChannelProperties)
+	(
+		int16_t																	handle,
+		PS2000A_TRIGGER_CHANNEL_PROPERTIES	*	channelProperties,
+		int16_t																	nChannelProperties,
+		int16_t																	auxOutputEnable,
+		int32_t																	autoTriggerMilliseconds
+	);
+
+
+/// <summary>
+/// This function sets up trigger conditions on the scope's inputs. The trigger is defined by
+/// one or more PS2000A_TRIGGER_CONDITIONS structures that are then ORed together. Each structure
+///  is itself the AND of the states of one or more of the inputs.This AND - OR logic allows
+/// you to create any possible Boolean function of the scope's inputs.
+///
+///  If complex triggering is not required, use ps2000aSetSimpleTrigger.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="conditions">An array of PS2000A_TRIGGER_CONDITIONS structures specifying the
+/// conditions that should be applied to each channel. In the simplest case, the array consists
+/// of a single element.When there is more than one element, the overall trigger condition is
+/// the logical OR of all the elements.</param>
+/// <param name="nConditions">The number of elements in the conditions array. If nConditions is zero
+/// then triggering is switched.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_CONDITIONS
+///	PICO_MEMORY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetTriggerChannelConditions)
+	(
+		int16_t													handle,
+		PS2000A_TRIGGER_CONDITIONS	*	conditions,
+		int16_t													nConditions
+	);
+
+/// <summary>
+/// This function sets the direction of the trigger for each channel.
+///
+/// If using a level trigger in conjunction with a pulse - width trigger, see the
+/// description of the direction argument to ps2000aSetPulseWidthQualifier for more information.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="channelA">The direction in which the signal must pass through the threshold
+/// to activate the trigger.</param>
+/// <param name="channelB">The direction in which the signal must pass through the threshold
+/// to activate the trigger.</param>
+/// <param name="channelC">The direction in which the signal must pass through the threshold
+/// to activate the trigger. Four channel variants only.</param>
+/// <param name="channelD">The direction in which the signal must pass through the threshold
+/// to activate the trigger. Four channel variants only.</param>
+/// <param name="ext">The direction in which the signal must pass through the threshold
+/// to activate the trigger.</param></param>
+/// <param name="aux">Not used.</param></param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetTriggerChannelDirections)
+	(
+		int16_t													handle,
+		PS2000A_THRESHOLD_DIRECTION		channelA,
+		PS2000A_THRESHOLD_DIRECTION		channelB,
+		PS2000A_THRESHOLD_DIRECTION		channelC,
+		PS2000A_THRESHOLD_DIRECTION		channelD,
+		PS2000A_THRESHOLD_DIRECTION		ext,
+		PS2000A_THRESHOLD_DIRECTION		aux
+	);
+
+/// <summary>
+/// This function sets the post-trigger delay, which causes capture to start a defined time
+/// after the trigger event.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="delay">The time between the trigger occurring and the first sample. For example,
+///  if delay=100 then the scope would wait 100 sample periods before sampling.At a timebase of
+///  1GS/s, or 1ns per sample, the total delay would then be 100 x 1 ns = 100 ns.Range:
+///			0 to MAX_DELAY_COUNT.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetTriggerDelay)
+	(
+		int16_t									handle,
+		uint32_t					delay
+	);
+
+/// <summary>
+/// This function sets up the conditions for pulse width qualification, which is used with
+///	either threshold triggering, level triggering or window triggering to produce
+/// time - qualified triggers.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="conditions">This function sets up the conditions for pulse width qualification,
+/// which is used with either threshold triggering, level triggering or window triggering to
+/// produce time - qualified triggers.</param>
+/// <param name="nConditions">The number of elements in the conditions array. If nConditions is
+/// zero then the pulse-width qualifier is not used. Range:
+///			0 to PS2000A_MAX_PULSE_WIDTH_QUALIFIER_COUNT.</param>
+/// <param name="directions">the direction of the signal required for the pulse width trigger to
+/// fire.See PS2000A_THRESHOLD_DIRECTION constants for the list of possible values.Each channel
+/// of the oscilloscope(except the EXT input) has two thresholds for each direction�for example,
+/// PS2000A_RISING and PS2000A_RISING_LOWER � so that one can be 	used for the pulse - width
+/// qualifier and the other for the level trigger.The driver will not let you use the same
+/// threshold for both triggers; so, for example, you cannot use PS2000A_RISING as the direction
+/// argument for both ps2000aSetTriggerConditions and ps2000aSetPulseWidthQualifier at the same
+/// time. There is no such restriction when using window triggers.</param>
+/// <param name="lower">The lower limit of the pulse-width counter, measured in sample periods.</param>
+/// <param name="upper">The upper limit of the pulse-width counter, measured in sample periods.
+/// This parameter is used only when the type is set to PS2000A_PW_TYPE_IN_RANGE or
+/// PS2000A_PW_TYPE_OUT_OF_RANGE.</param>
+/// <param name="type">The pulse-width type.</param>
+/// <returns>
+///	PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetPulseWidthQualifier)
+	(
+		int16_t													handle,
+		PS2000A_PWQ_CONDITIONS			*	conditions,
+		int16_t													nConditions,
+		PS2000A_THRESHOLD_DIRECTION		direction,
+		uint32_t									lower,
+		uint32_t									upper,
+		PS2000A_PULSE_WIDTH_TYPE			type
+	);
+
+/// <summary>
+/// This function discovers whether a trigger, or pulse width triggering, is enabled.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="triggerEnabled">on exit, indicates whether the trigger will successfully
+/// be set when ps2000aRunBlock or ps2000aRunStreaming is called.A non - zero value indicates
+/// that the trigger is set, zero that the trigger is not set.</param>
+/// <param name="pulseWidthQualifierEnabled">on exit, indicates whether the pulse width
+/// qualifier will successfully be set when ps2000aRunBlock or ps2000aRunStreaming is
+/// called.A non - zero value indicates that the pulse width qualifier is set, zero that
+/// the pulse width qualifier is not set.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NULL_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aIsTriggerOrPulseWidthQualifierEnabled)
+	(
+		int16_t 								handle,
+		int16_t 							* triggerEnabled,
+		int16_t 							* pulseWidthQualifierEnabled
+	);
+
+/// <summary>
+/// This function gets the time, as two 4-byte values, at which the trigger occurred. Call it
+/// after block - mode data has been captured or when data has been retrieved from a
+/// previous block - mode capture.A 64 - bit version of this function,
+/// ps2000aGetTriggerTimeOffset64, is also available.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="timeUpper">on exit, the upper 32 bits of the time at which the trigger point occurred.</param>
+/// <param name="timeLower">on exit, the lower 32 bits of the time at which the trigger point occurred.</param>
+/// <param name="timeUnits">returns the time units in which timeUpper and timeLower are measured.</param>
+/// <param name="segmentIndex">the number of the memory segment for which the information is required.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DEVICE_SAMPLING
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_NOT_USED_IN_THIS_CAPTURE_MODE
+///	PICO_NOT_RESPONDING
+///	PICO_NULL_PARAMETER
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetTriggerTimeOffset)
+	(
+		int16_t									handle,
+		uint32_t 			* timeUpper,
+		uint32_t 			* timeLower,
+		PS2000A_TIME_UNITS	*	timeUnits,
+		uint32_t				segmentIndex
+	);
+
+/// <summary>
+/// This function gets the time, as a single 64-bit value, at which the trigger occurred. Call
+/// it after block - mode data has been captured or when data has been retrieved from a
+/// previous block - mode capture.A 32 - bit version of this function, ps2000aGetTriggerTimeOffset,
+/// is also available.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="time">On exit, the time at which the trigger point occurred.</param>
+/// <param name="timeUnits">On exit, the time units in which time is measured.</param>
+/// <param name="segmentIndex">Yhe number of the memory segment for which the information is required.</param>
+/// <returns>
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetTriggerTimeOffset64)
+	(
+		int16_t									handle,
+		int64_t							* time,
+		PS2000A_TIME_UNITS	*	timeUnits,
+		uint32_t				segmentIndex
+	);
+
+/// <summary>
+/// This function retrieves the time offsets, as lower and upper 32-bit values, for
+/// waveforms obtained in rapid block mode.The time offset of a waveform is the delay
+/// from the trigger sampling instant to the time at which the driver estimates the
+///	waveform to have crossed the trigger threshold.You can add this offset to the time of
+/// each sample in the waveform to reduce trigger jitter.Without using the time offset,
+/// trigger jitter can be up to 1 sample period; adding the time offset reduces jitter to a
+/// small fraction of a sample period.This function is provided for use in programming
+/// environments that do not support 64 - bit integers.If your programming environment
+/// supports this data type, it is easier to use ps2000aGetValuesTriggerTimeOffsetBulk64.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="timeUpper">An array of integers. On exit, the most significant 32
+///	bits of the time offset for each requested segment index.times[0] will hold the
+/// fromSegmentIndex time offset and the last times index will hold the toSegmentIndex
+/// time offset.The array must be long enough to hold the number of requested times.</param>
+/// <param name="timeLower">An array of integers. On exit, the least significant 32 bits
+/// of the time offset for each requested segment index.times[0] will hold the
+/// fromSegmentIndex time offset and the last times index will hold the toSegmentIndex
+/// time offset.The array size must be long enough to hold the number of requested times.</param>
+/// <param name="timeUnits">An array of integers. The array must be long enough to hold
+/// the number of requested times.On exit, timeUnits[0] will contain the time unit for
+/// fromSegmentIndex and the last element will contain the time unit for toSegmentIndex.
+/// Refer to ps2000aGetTriggerTimeOffset for allowable values.</param>
+/// <param name="fromSegmentIndex">The first segment for which the time offset is required</param>
+/// <param name="toSegmentIndex">The last segment for which the time offset is required.
+/// If toSegmentIndex is less than fromSegmentIndex then the driver will wrap around
+/// from the last segment to the first.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NOT_USED_IN_THIS_CAPTURE_MODE
+///	PICO_NOT_RESPONDING
+///	PICO_NULL_PARAMETER
+///	PICO_DEVICE_SAMPLING
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesTriggerTimeOffsetBulk)
+	(
+	  int16_t									handle,
+		uint32_t				*	timesUpper,
+		uint32_t				* timesLower,
+		PS2000A_TIME_UNITS	*	timeUnits,
+		uint32_t				fromSegmentIndex,
+		uint32_t				toSegmentIndex
+	);
+
+/// <summary>
+/// This function retrieves the 64-bit time offsets for waveforms captured in rapid block mode.
+/// A 32 - bit version of this function, ps2000aGetValuesTriggerTimeOffsetBulk, is available
+/// for use with programming languages that do not support 64 - bit integers.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="times">an array of integers. On exit, this will hold the time offset
+///	for each requested segment index.times[0] will hold the time offset for fromSegmentIndex,
+/// and the last times index will hold the time offset for toSegmentIndex.The array must be
+/// long enough to hold the number of times requested.</param>
+/// <param name="timeUnits">an array of integers long enough to hold the number of requested
+/// times.timeUnits[0] will contain the time unit for fromSegmentIndex, and the last element
+/// will contain the toSegmentIndex. Refer to ps2000aGetTriggerTimeOffset64 for specific
+/// figures.</param>
+/// <param name="fromSegmentIndex">the first segment for which the time offset is required.
+/// The results for this segment will be placed in times[0] and timeUnits[0].</param>
+/// <param name="toSegmentIndex">the last segment for which the time offset is required.
+/// The results for this segment will be placed in the last elements of the times and
+/// timeUnits arrays.If toSegmentIndex is less than fromSegmentIndex then the driver
+/// will wrap around from the last segment to the first.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NOT_USED_IN_THIS_CAPTURE_MODE
+///	PICO_NOT_RESPONDING
+///	PICO_NULL_PARAMETER
+///	PICO_DEVICE_SAMPLING
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesTriggerTimeOffsetBulk64)
+	(
+	  int16_t									handle,
+		int64_t							*	times,
+		PS2000A_TIME_UNITS	*	timeUnits,
+		uint32_t				fromSegmentIndex,
+		uint32_t				toSegmentIndex
+	);
+
+/// <summary>
+/// This function sets the number of captures to be collected in one run of rapid block
+/// mode. If you do not call this function before a run, the driver will capture only one
+/// waveform. Once a value has been set, the value remains constant unless changed.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="">the number of waveforms to capture in one run.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetNoOfCaptures)
+	(
+	  int16_t								handle,
+		uint32_t			*	nCaptures
+	);
+
+/// <summary>
+/// This function finds out how many captures in rapid block mode have been processed
+///	after ps2000aRunBlock has been called when either the collection completed or the
+///	collection of waveforms was interrupted by calling ps2000aStop.The returned value
+///	(nCaptures) can then be used to iterate through the number of segments using
+///	ps2000aGetValues, or in a single call to ps2000aGetValuesBulk where it is used to
+///	calculate the toSegmentIndex parameter.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="nProcessedCaptures">Output: the number of available captures that has
+///	been collected from calling ps2000aRunBlock.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_NULL_PARAMETER
+///	PICO_INVALID_PARAMETER
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_TOO_MANY_SAMPLES
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetNoOfProcessedCaptures)
+	(
+	  int16_t								handle,
+		uint32_t			*	nProcessedCaptures
+	);
+
+/// <summary>
+/// This function tells the driver where to store the data, either unprocessed or
+///	downsampled, that will be returned after the next call to one of the GetValues
+///	functions.The function allows you to specify only a single buffer, so for aggregation
+///	mode, which requires two buffers, you need to call ps2000aSetDataBuffers instead.
+///
+/// You must allocate memory for the buffer before calling this function.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="channelOrPort">The analogue channel you want to use with the buffer.
+/// To set the buffer for a digital port (MSO models only), use one of these values :
+///			PS2000A_DIGITAL_PORT0 = 0x80
+///			PS2000A_DIGITAL_PORT1 = 0x81</param>
+/// <param name="buffer">The location of the buffer.</param>
+/// <param name="bufferLth">The size of the buffer array.</param>
+/// <param name="segmentIndex">The number of the memory segment to be used.</param>
+/// <param name="mode">The downsampling mode. See PS2000A_RATIO_MODE for the available modes.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_CHANNEL
+///	PICO_RATIO_MODE_NOT_SUPPORTED
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetDataBuffer)
+(
+   int16_t								 handle,
+	 int32_t						 			 channelOrPort,
+	 int16_t							*  buffer,
+   int32_t									 bufferLth,
+	 uint32_t				 segmentIndex,
+	 PS2000A_RATIO_MODE		 mode
+);
+
+/// <summary>
+/// This function tells the driver the location of one or two buffers for receiving data. You
+///	need to allocate memory for the buffers before calling this function.If you do not need
+///	two buffers, because you are not using aggregate mode, you can optionally use
+///	ps2000aSetDataBuffer instead.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="channelOrPort">The analogue channel you want to use with the buffer.
+/// To set the buffer for a digital port (MSO models only), use one of these values :
+///			PS2000A_DIGITAL_PORT0 = 0x80
+///			PS2000A_DIGITAL_PORT1 = 0x81</param>
+/// <param name="bufferMax">A buffer to receive the maximum data values in aggregation mode,
+/// or the non - aggregated values otherwise.</param>
+/// <param name="bufferMin">A buffer to receive the minimum aggregated data values. Not used
+/// in other downsampling modes.</param>
+/// <param name="bufferLth">The size of the buffer array.</param>
+/// <param name="segmentIndex">The number of the memory segment to be used.</param>
+/// <param name="mode">The downsampling mode. See PS2000A_RATIO_MODE for the available modes.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_CHANNEL
+///	PICO_RATIO_MODE_NOT_SUPPORTED
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetDataBuffers)
+(
+   int16_t								 handle,
+	 int32_t						 			 channelOrPort,
+	 int16_t							 * bufferMax,
+	 int16_t							 * bufferMin,
+   int32_t									 bufferLth,
+	 uint32_t				 segmentIndex,
+	 PS2000A_RATIO_MODE		 mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSetUnscaledDataBuffers)
+(
+	int16_t               handle,
+	PS2000A_CHANNEL     channelOrPort,
+	int8_t              *bufferMax,
+	int8_t              *bufferMin,
+	int32_t                bufferLth,
+	uint32_t      segmentIndex,
+	PS2000A_RATIO_MODE  mode
+);
+/// <summary>
+/// This function tells the driver where to find your application's ETS time buffers. These
+///	buffers contain the 64 - bit timing information for each ETS sample after you run a
+///	block - mode ETS capture.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="buffer">An array of 64-bit words, each representing the time in
+/// femtoseconds(10^-15s) at which the sample was captured.</param>
+/// <param name="bufferLth">The size of the buffer array.</param>
+/// <returns>
+/// PICO_OK
+/// PICO_INVALID_HANDLE
+/// PICO_NULL_PARAMETER
+/// PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetEtsTimeBuffer)
+(
+   int16_t									handle,
+	 int64_t *							buffer,
+	 int32_t										bufferLth
+);
+
+/// <summary>
+/// This function tells the driver where to find your application's ETS time buffers. These
+/// buffers contain the timing information for each ETS sample after you run a block - mode
+///	ETS capture.There are two buffers containing the upper and lower 32 - bit parts of the
+///	timing information, to allow programming languages that do not support 64 - bit data to
+///	retrieve the timings.
+
+/// If your programming language supports 64 - bit data then you can use ps2000aSetEtsTimeBuffer
+/// instead.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="timeUpper">An array of 32-bit words, each representing the upper
+/// 32 bits of the time in femtoseconds(10^�15s) at which the sample was captured.</param>
+/// <param name="timeLower">An array of 32-bit words, each representing the lower
+///	32 bits of the time in femtoseconds(10^�15s) at which the sample was captured.</param>
+/// <param name="bufferLth">The size of the timeUpper and timeLower arrays.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NULL_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aSetEtsTimeBuffers)
+(
+   int16_t									handle,
+	 uint32_t				* timeUpper,
+	 uint32_t				* timeLower,
+	 int32_t										bufferLth
+);
+
+/// <summary>
+/// This function may be used instead of a callback function to receive data from
+///	ps2000aRunBlock.To use this method, pass a NULL pointer as the lpReady argument
+///	to ps2000aRunBlock.You must then poll the driver to see if it has finished collecting
+///	the requested samples.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="ready">Output: indicates the state of the collection. If zero, the
+///	device is still collecting.If non - zero, the device has finished collecting and
+/// ps2000aGetValues can be used to retrieve the data.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_NULL_PARAMETER
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_CANCELLED
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aIsReady)
+	(
+		int16_t handle,
+		int16_t * ready
+	);
+
+/// <summary>
+/// This function starts collecting data in block mode. For a step-by-step guide to this
+///	process, see Using block mode.The number of samples is determined by noOfPreTriggerSamples
+///	and noOfPostTriggerSamples(see below for details).The total number of samples must
+///	not be more than the size of the segment referred to by segmentIndex.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="noOfPreTriggerSamples">The number of samples to store before the trigger event.</param>
+/// <param name="noOfPostTriggerSamples">The number of samples to store after the trigger event.
+///			Note: the maximum number of samples returned is always noOfPreTriggerSamples +
+///			noOfPostTriggerSamples. This is true even if no trigger event has been set.</param>
+/// <param name="timebase">A number in the range 0 to 2 32�1.See the guide to calculating timebase
+/// values.This argument is ignore.</param>
+/// <param name="oversample">Not used.</param>
+/// <param name="timeIndisposedMs">On exit, the time, in milliseconds, that the scope will spend
+/// collecting samples.This does not include any auto trigger timeout. It is not valid in ETS
+/// capture mode.The pointer can be set to null if a value is not required.</param>
+/// <param name="segmentIndex">Zero-based, which memory segment to use.</param>
+/// <param name="lpReady">A pointer to the ps2000aBlockReady callback function that the driver
+/// will call when the data has been collected.To use the ps2000aIsReady polling method instead
+/// of a callback function, set this pointer to NULL.</param>
+/// <param name="pParameter">a void pointer that is passed to the ps2000aBlockReady callback
+/// function.The callback can use this pointer to return arbitrary data to the application.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_BUFFERS_NOT_SET(in Overlapped mode)
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_TRIGGER_CHANNEL
+///	PICO_INVALID_CONDITION_CHANNEL
+///	PICO_TOO_MANY_SAMPLES
+///	PICO_INVALID_TIMEBASE
+///	PICO_NOT_RESPONDING
+///	PICO_CONFIG_FAIL
+///	PICO_INVALID_PARAMETER
+///	PICO_NOT_RESPONDING
+///	PICO_TRIGGER_ERROR
+///	PICO_DRIVER_FUNCTION
+///	PICO_FW_FAIL
+///	PICO_NOT_ENOUGH_SEGMENTS(in Bulk mode)
+///	PICO_PULSE_WIDTH_QUALIFIER
+///	PICO_SEGMENT_OUT_OF_RANGE(in Overlapped mode)
+///	PICO_STARTINDEX_INVALID(in Overlapped mode)
+///	PICO_INVALID_SAMPLERATIO(in Overlapped mode)
+///	PICO_CONFIG_FAIL
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aRunBlock)
+	(
+		int16_t									handle,
+		int32_t									noOfPreTriggerSamples,
+		int32_t									noOfPostTriggerSamples,
+		uint32_t					timebase,
+		int16_t									oversample,
+		int32_t								* timeIndisposedMs,
+		uint32_t				segmentIndex,
+		ps2000aBlockReady			lpReady,
+		void								* pParameter
+	);
+
+/// <summary>
+/// This function tells the oscilloscope to start collecting data in streaming mode. When
+///	data has been collected from the device it is downsampled if necessary and then
+///	delivered to the application.Call ps2000aGetStreamingLatestValues to retrieve the
+///	data. See Using streaming mode for a step - by - step guide to this process.When a
+/// trigger is set, the total number of samples stored in the driver is the sum of
+/// maxPreTriggerSamples and maxPostTriggerSamples.If autoStop is false, this will
+///	become the maximum number of samples without downsampling.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="sampleInterval">On entry, the requested time interval between samples; on exit, the actual
+/// time interval used.</param>
+/// <param name="sampleIntervalTimeUnits">The maximum number of raw samples before a trigger event for each enabled
+/// channel.If no trigger condition is set this argument is ignored.</param>
+/// <param name="maxPreTriggerSamples">The maximum number of raw samples after a trigger event for each enabled channel.
+/// If no trigger condition is set, this argument states the maximum number of samples to be stored.</param>
+/// <param name="maxPostPreTriggerSamples">A flag that specifies if the streaming should stop when all of maxSamples
+/// have been captured.</param>
+/// <param name="autoStop">A flag that specifies if the streaming should stop when all of maxSamples have
+/// been captured.</param>
+/// <param name="downSampleRatio">The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE for available modes.</param>
+/// <param name="overviewBufferSize">The size of the overview buffers. These are temporary buffers used for storing
+/// the data before returning it to the application.The size is the same as the bufferLth value passed
+/// to ps2000aSetDataBuffer.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_ETS_MODE_SET
+///	PICO_USER_CALLBACK
+///	PICO_NULL_PARAMETER
+///	PICO_INVALID_PARAMETER
+///	PICO_STREAMING_FAILED
+///	PICO_NOT_RESPONDING
+///	PICO_TRIGGER_ERROR
+///	PICO_INVALID_SAMPLE_INTERVAL
+///	PICO_INVALID_BUFFER
+///	PICO_DRIVER_FUNCTION
+///	PICO_FW_FAIL
+///	PICO_MEMORY
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aRunStreaming)
+  (
+	  int16_t									handle,
+		uint32_t				* sampleInterval,
+		PS2000A_TIME_UNITS		sampleIntervalTimeUnits,
+	  uint32_t					maxPreTriggerSamples,
+	  uint32_t					maxPostPreTriggerSamples,
+		int16_t									autoStop,
+		uint32_t					downSampleRatio,
+		PS2000A_RATIO_MODE		downSampleRatioMode,
+    uint32_t					overviewBufferSize
+	);
+
+/// <summary>
+/// This function instructs the driver to return the next block of values to your
+///	ps2000aStreamingReady callback function.You must have previously called
+///	ps2000aRunStreaming beforehand to set up streaming.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="lpPs2000aReady">a pointer to your ps2000aStreamingReady callback function.</param>
+/// <param name="pParameter">a void pointer that will be passed to the ps2000aStreamingReady
+/// callback function.The callback function may optionally use this pointer to return
+/// information to the application.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_INVALID_CALL
+///	PICO_BUSY
+///	PICO_NOT_RESPONDING
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetStreamingLatestValues)
+  (
+    int16_t									handle,
+    ps2000aStreamingReady	lpPs2000aReady,
+		void								* pParameter
+  );
+
+/// <summary>
+/// This function returns the number of samples available after data collection in
+///	streaming mode.Call it after calling ps2000aStop.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="noOfValues">On exit, the number of samples.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NULL_PARAMETER
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_NOT_USED
+///	PICO_BUSY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aNoOfStreamingValues)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfValues
+	);
+
+/// <summary>
+/// This function returns the maximum downsampling ratio that can be used for a given
+///	number of samples in a given downsampling mode
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="noOfUnaggreatedSamples">The number of unprocessed samples to be downsampled.</param>
+/// <param name="maxDownSampleRatio">The maximum possible downsampling ratio output.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE available modes.</param>
+/// <param name="segmentIndex">The memory segment where the data is stored.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_NULL_PARAMETER
+///	PICO_INVALID_PARAMETER
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_TOO_MANY_SAMPLES
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetMaxDownSampleRatio)
+	(
+	  int16_t								handle,
+		uint32_t 			noOfUnaggreatedSamples,
+		uint32_t 		* maxDownSampleRatio,
+		PS2000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t			segmentIndex
+	);
+
+/// <summary>
+/// This function returns block-mode data, with or without downsampling, starting at the
+///	specified sample number.It is used to get the stored data from the driver after data
+///	collection has stopped.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startIndex">A zero-based index that indicates the start point for
+///	data collection.It is measured in sample intervals from the start of the buffer.</param>
+/// <param name="noOfSamples">On entry, the number of samples required. On exit,
+/// the actual number retrieved. The number of samples retrieved will not be more than the
+/// number requested, and the data retrieved starts at startIndex.</param>
+/// <param name="downSampleRatio">The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">Downsampling mode to use. The available values are :
+///			PS2000A_RATIO_MODE_NONE(downSampleRatio is ignored)
+///			PS2000A_RATIO_MODE_AGGREGATE
+///			PS2000A_RATIO_MODE_AVERAGE
+///			PS2000A_RATIO_MODE_DECIMATE
+///	AGGREGATE, AVERAGE, DECIMATE are single - bit constants that can be ORed to apply multiple
+/// downsampling modes to the same data.</param>
+/// <param name="segmentIndex">The zero-based number of the memory segment 	where the data is stored.</param>
+/// <param name="overflow">On exit, a set of flags that indicate whether an overvoltage has occurred
+/// on any of the channels.It is a bit field with bit 0 denoting Channel.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_DEVICE_SAMPLING
+///	PICO_NULL_PARAMETER
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_STARTINDEX_INVALID
+///	PICO_ETS_NOT_RUNNING
+///	PICO_BUFFERS_NOT_SET
+///	PICO_INVALID_PARAMETER
+///	PICO_TOO_MANY_SAMPLES
+///	PICO_DATA_NOT_AVAILABLE
+///	PICO_STARTINDEX_INVALID
+///	PICO_INVALID_SAMPLERATIO
+///	PICO_INVALID_CALL
+///	PICO_NOT_RESPONDING
+///	PICO_MEMORY
+///	PICO_RATIO_MODE_NOT_SUPPORTED
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValues)
+	(
+	  int16_t								handle,
+		uint32_t 			startIndex,
+	  uint32_t			*	noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS2000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t			segmentIndex,
+		int16_t							* overflow
+	);
+
+/// <summary>
+/// This function retrieves waveforms captured using rapid block mode. The waveforms
+///	must have been collected sequentially and in the same run.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="noOfSamples">On entry, the number of samples required; on exit, the actual
+///  number retrieved. The number of samples retrieved will not be more than the number
+///  requested.The data retrieved always starts with the first sample captured.</param>
+/// <param name="fromSegmentIndex">The first segment from which the waveform should be retrieved.</param>
+/// <param name="toSegmentIndex">The last segment from which the waveform should be retrieved.</param>
+/// <param name="downSampleRatio">The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE for available modes.</param>
+/// <param name="overflow">An array of integers equal to or larger than the number of waveforms to
+/// be retrieved.Each segment index has a corresponding entry in the overflow array, with overflow[0]
+/// containing the flags for the segment numbered fromSegmentIndex and the last element in the
+/// array containing the flags for the segment numbered toSegmentIndex. Each element in the array
+/// is a bit field.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_INVALID_SAMPLERATIO
+///	PICO_ETS_NOT_RUNNING
+///	PICO_BUFFERS_NOT_SET
+///	PICO_TOO_MANY_SAMPLES
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_NOT_RESPONDING
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesBulk)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfSamples,
+		uint32_t			fromSegmentIndex,
+		uint32_t			toSegmentIndex,
+	  uint32_t				downSampleRatio,
+		PS2000A_RATIO_MODE 	downSampleRatioMode,
+		int16_t							* overflow
+	);
+
+/// <summary>
+/// This function returns data either with or without downsampling, starting at the
+/// specified sample number.It is used to get the stored data from the scope after data
+/// collection has stopped.It returns the data using a callback.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startIndex">A zero-based index that indicates the start point for data collection.
+/// It is measured in sample intervals from the start of the buffer.</param>
+/// <param name="noOfSamples">On entry, the number of samples required. On exit, the actual number
+/// retrieved. The number of samples retrieved will not be more than the number requested, and the
+/// data retrieved starts at startIndex.</param>
+/// <param name="downSampleRatio">See The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE fro available modes.</param>
+/// <param name="segmentIndex">The zero-based number of the memory segment where the data is stored.</param>
+/// <param name="lpDataReady">A pointer to the user-supplied function that will be
+///	called when the data is ready.This will be a ps2000aDataReady function for
+/// block - mode data or a ps2000aStreamingReady function for streaming - mode data.</param>
+/// <param name="pParameter">a void pointer that will be passed to the callback function.The
+/// data type is determined by the application.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_DEVICE_SAMPLING
+///	PICO_NULL_PARAMETER
+///	PICO_STARTINDEX_INVALID
+///	PICO_SEGMENT_OUT_OF_RANGE
+///	PICO_INVALID_PARAMETER
+///	PICO_DATA_NOT_AVAILABLE
+///	PICO_INVALID_SAMPLERATIO
+///	PICO_INVALID_CALL
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesAsync)
+	(
+	  int16_t								handle,
+		uint32_t				startIndex,
+	  uint32_t				noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS2000A_RATIO_MODE		downSampleRatioMode,
+		uint32_t			segmentIndex,
+	  void							*	lpDataReady,
+		void							*	pParameter
+	);
+
+/// <summary>
+/// This function allows you to make a deferred data-collection request in block mode. The
+///	request will be executed, and the arguments validated, when you call
+///	ps2000aRunBlock.The advantage of this function is that the driver makes contact with
+///	the scope only once, when you call ps2000aRunBlock, compared with the two contacts
+///	that occur when you use the conventional ps2000aRunBlock, ps2000aGetValues
+///	calling sequence.This slightly reduces the dead time between successive captures in
+///	block mode.
+///
+/// After calling ps2000aRunBlock, you can optionally use ps2000aGetValues to request
+///	further copies of the data.This might be required if you wish to display the data with
+///	different data reduction settings.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startIndex">A zero-based index that indicates the start point for data
+/// collection.It is measured in sample intervals from the start of the buffer</param>
+/// <param name="noOfSamples">n entry, the number of raw samples to be collected before any
+/// downsampling is applied.On exit, the actual number stored in the buffer.The number of
+/// samples retrieved will not be more than the number requested, and the data retrieved
+/// starts at startIndex.</param>
+/// <param name="downSampleRatio">The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE for available modes.</param>
+/// <param name="segmentIndex">The zero-based number of the memory segment where the data is stored.</param>
+/// <param name="overflow">An array of integers equal to or larger than the number of waveforms to
+/// be retrieved.Each segment index has a corresponding entry in the overflow array, with overflow[0]
+///	containing the flags for the segment numbered fromSegmentIndex and the last element in the array
+/// containing the flags for the segment numbered toSegmentIndex.Each element in the array is a bit field</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesOverlapped)
+	(
+	  int16_t								handle,
+	  uint32_t 			startIndex,
+	  uint32_t			*	noOfSamples,
+	  uint32_t				downSampleRatio,
+	  PS2000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t      segmentIndex,
+	  int16_t				*       overflow
+	);
+
+
+/// <summary>
+/// This function allows you to make a deferred data-collection request, which will later be
+///	executed, and the arguments validated, when you call ps2000aRunBlock in rapid block
+///	mode.The advantage of this method is that the driver makes contact with the scope
+///	only once, when you call ps2000aRunBlock, compared with the two contacts that occur
+///	when you use the conventional ps2000aRunBlock, ps2000aGetValuesBulk calling
+///	sequence.This slightly reduces the dead time between successive captures in rapid
+///	block mode.
+///
+/// After calling ps2000aRunBlock, you can optionally use ps2000aGetValues to request
+///	further copies of the data.This might be required if you wish to display the data with
+///	different data reduction settings.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="startIndex">A zero-based index that indicates the start point for data
+/// collection.It is measured in sample intervals from the start of the buffer</param>
+/// <param name="noOfSamples">On entry, the number of samples required; on exit, the actual
+///  number retrieved. The number of samples retrieved will not be more than the number
+///  requested.The data retrieved always starts with the first sample captured.</param>
+/// <param name="downSampleRatio">The downsampling factor that will be applied to the raw data.</param>
+/// <param name="downSampleRatioMode">See PS2000A_RATIO_MODE for available modes.</param>
+/// <param name="fromSegmentIndex">The first segment from which the waveform should be retrieved.</param>
+/// <param name="toSegmentIndex">The last segment from which the waveform should be retrieved.</param>
+/// <param name="overflow">An array of integers equal to or larger than the number of waveforms to
+/// be retrieved.Each segment index has a corresponding entry in the overflow array, with overflow[0]
+/// containing the flags for the segment numbered fromSegmentIndex and the last element in the
+/// array containing the flags for the segment numbered toSegmentIndex. Each element in the array
+/// is a bit field.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_INVALID_PARAMETER
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetValuesOverlappedBulk)
+	(
+	  int16_t								handle,
+		uint32_t				startIndex,
+  	uint32_t 	 	*	noOfSamples,
+	  uint32_t				downSampleRatio,
+	  PS2000A_RATIO_MODE	downSampleRatioMode,
+	  uint32_t			fromSegmentIndex,
+	  uint32_t			toSegmentIndex,
+	  int16_t							*	overflow
+	);
+
+/// <summary>
+/// This function stops the scope device from sampling data. If this function is called
+/// before a trigger event occurs, the oscilloscope may not contain valid data. Always
+/// call this function after the end of a capture to ensure that the scope is ready
+///	for the next capture.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_USER_CALLBACK
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aStop)
+	(
+	  int16_t handle
+	);
+
+/// <summary>
+/// This function has no effect and is reserved for future use.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="holdoff">Reserved for future use.</param>
+/// <param name="type">Reserved for future use.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_NULL_PARAMETER
+///	PICO_NO_SAMPLES_AVAILABLE
+///	PICO_NOT_USED
+///	PICO_BUSY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aHoldOff)
+	(
+	  int16_t								handle,
+		uint64_t						holdoff,
+		PS2000A_HOLDOFF_TYPE	type
+	);
+
+/// <summary>
+/// This function queries which ranges are available on a scope device.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="info">The type of information required.
+///  The following value iscurrently supported : PS2000A_CI_RANGES</param>
+/// <param name="probe">Not used, must be set to 0.</param>
+/// <param name="ranges">An array that will be populated with available PS2000A_RANGE
+/// values for the given info.If NULL, length is set tothe number of ranges available.</param>
+/// <param name="length">Input: length of ranges array; output: number of elements
+///  written to ranges.</param>
+/// <param name="channels">The channel for which the information is required.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_HANDLE_INVALID
+///	PICO_BUSY
+///	PICO_DRIVER_FUNCTION
+///	PICO_NOT_RESPONDING
+///	PICO_NULL_PARAMETER
+///	PICO_INVALID_CHANNEL
+///	PICO_INVALID_INFO
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetChannelInformation)
+	(
+		int16_t handle,
+		PS2000A_CHANNEL_INFO info,
+		int32_t probe,
+		int32_t * ranges,
+		int32_t * length,
+		int32_t channels
+  );
+
+/// <summary>
+/// This function counts the number of PicoScope 2000 Series (A API) units connected to
+///	the computer, and returns a list of serial numbers as a string.
+/// </summary>
+/// <param name="count">On exit, the number of ps2000a units found.</param>
+/// <param name="serials">On exit, a list of serial numbers separated by commas and terminated
+/// by a final null.
+///
+///				Example: AQ005 / 139, VDR61 / 356, ZOR14 / 107
+///
+/// Can be NULL on entry if serial numbers are not required.</param>
+/// <param name="serialLth">On entry, the length of the char buffer pointed to by serials;
+/// on exit, the length of the string written to serials.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_BUSY
+///	PICO_NULL_PARAMETER
+///	PICO_FW_FAIL
+///	PICO_CONFIG_FAIL
+///	PICO_MEMORY_FAIL
+///	PICO_CONFIG_FAIL_AWG
+///	PICO_INITIALISE_FPGA
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aEnumerateUnits)
+	(
+	int16_t * count,
+	int8_t * serials,
+	int16_t * serialLth
+	);
+
+/// <summary>
+/// This function can be used to check that the already opened device is still connected to
+///	the USB port and communication is successful.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_BUSY
+///	PICO_NOT_RESPONDING
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aPingUnit)
+	(
+	int16_t handle
+	);
+
+/// <summary>
+/// This function returns the maximum ADC count returned by calls to the "GetValues"
+///	functions.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="value">Output: the maximum ADC value.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_HANDLE
+///	PICO_TOO_MANY_SEGMENTS
+///	PICO_MEMORY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aMaximumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+/// <summary>
+/// This function returns the minimum ADC count returned by calls to the GetValues
+///	functions
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="value">Output: the minimum ADC value.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_USER_CALLBACK
+///	PICO_INVALID_HANDLE
+///	PICO_TOO_MANY_SEGMENTS
+///	PICO_MEMORY
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aMinimumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+/// <summary>
+/// This function is used to get the maximum and minimum allowable analog offset for a
+///	specific voltage range.
+///
+///	If both maximumVoltage and minimumVoltage are NULL, the driver will return PICO_NULL_PARAMETER
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="range">The voltage range to be used when gathering the min and max information.</param>
+/// <param name="coupling">The type of AC/DC coupling used</param>
+/// <param name="maximumVoltage">Output: maximum voltage allowed for the range. Pointer will be
+/// ignored if NULL.If device does not support analog offset, zero will be returned.</param>
+/// <param name="minimumVoltage">Output: minimum voltage allowed for the range. Pointer will
+/// be ignored if NULL. If device does not support analog offset, zero will be returned.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_INVALID_VOLTAGE_RANGE
+///	PICO_NULL_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetAnalogueOffset)
+	(
+	int16_t handle,
+	PS2000A_RANGE range,
+	PS2000A_COUPLING	coupling,
+	float * maximumVoltage,
+	float * minimumVoltage
+	);
+
+/// <summary>
+/// This function returns the maximum number of segments allowed for the opened
+///	variant.Refer to ps2000aMemorySegments for specific figures.
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="maxSegments">Output: maximum number of segments allowed.</param>
+/// <returns>
+/// PICO_OK
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+///	PICO_NULL_PARAMETER
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps2000aGetMaxSegments)
+	(
+	int16_t		handle,
+	uint32_t * maxSegments
+	);
+
+/// <summary>
+/// Retrieves the current state of the output edge detect flag
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="state">Output: The current of the output edge detect</param>
+/// <returns>
+/// PICO_OK
+/// PICO_NOT_USED
+/// PICO_NULL_PARAMETER
+/// PICO_NOT_SUPPORTED_BY_THIS_DEVICE
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+	);
+
+/// <summary>
+/// Sets the state of the output edge detect flag, Default value is TRUE
+/// </summary>
+/// <param name="handle">Device identifier returned by ps2000aOpenUnit.</param>
+/// <param name="state">The output edge detect state to be set:
+///			any none 0 value: enable
+///			0: disable</param>
+/// <returns>
+/// PICO_OK
+/// PICO_NOT_USED
+/// PICO_NULL_PARAMETER
+/// PICO_NOT_SUPPORTED_BY_THIS_DEVICE
+///	PICO_INVALID_HANDLE
+///	PICO_DRIVER_FUNCTION
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps2000aGetScalingValues)
+(
+	int16_t	handle,
+	PS2000A_SCALING_FACTORS_VALUES *scalingValues,
+	int16_t nChannels
+);
+
+#endif

+ 597 - 0
pico-tcp-service/pico-tcp/inc/ps3000.h

@@ -0,0 +1,597 @@
+/****************************************************************************
+ *
+ * Filename:    ps3000.h
+ * Author:      MTB & MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 3000 Series PC Oscilloscopes.
+ *
+ * Copyright � 2002 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef PS3000_H
+#define PS3000_H
+
+#include <stdint.h>
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+#ifdef PREF4
+  #undef PREF4
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+/*  If you are dynamically linking ps3000.dll into your project #define DYNLINK here
+ */
+#ifdef WIN32
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+  #define PREF4 __stdcall
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+#define PS3000_FIRST_USB  1
+#if defined (_DEBUG)
+#define PS3000_LAST_USB   64
+#else
+#define PS3000_LAST_USB 127
+#endif
+
+/* Maximum number of PS3000 units that can be opened at once
+ */
+#define PS3000_MAX_UNITS (PS3000_LAST_USB - PS3000_FIRST_USB + 1)
+
+#define PS3206_MAX_TIMEBASE  21
+#define PS3205_MAX_TIMEBASE  20
+#define PS3204_MAX_TIMEBASE  19
+#define PS3224_MAX_TIMEBASE  19
+#define PS3223_MAX_TIMEBASE  19
+#define PS3424_MAX_TIMEBASE  19
+#define PS3423_MAX_TIMEBASE  19
+
+#define PS3225_MAX_TIMEBASE  18
+#define PS3226_MAX_TIMEBASE  19
+#define PS3425_MAX_TIMEBASE  19
+#define PS3426_MAX_TIMEBASE  19
+
+#define PS3000_MAX_OVERSAMPLE 256
+
+/* Although the PS3000 uses an 8-bit ADC, it is usually possible to
+ * oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+
+#define PS3000_MAX_VALUE  32767
+#define PS3000_MIN_VALUE -32767
+#define PS3000_LOST_DATA -32768
+
+/*
+ * Signal generator constants. Note that a signal generator is not
+ * available on all variants.
+ */
+#define PS3000_MIN_SIGGEN_FREQ  0.093
+#define PS3000_MAX_SIGGEN_FREQ  1000000L
+
+/*
+ * ETS constants
+ */
+#define PS3206_MAX_ETS_CYCLES      500
+#define PS3206_MAX_ETS_INTERLEAVE  100
+
+#define PS3205_MAX_ETS_CYCLES      250
+#define PS3205_MAX_ETS_INTERLEAVE   50
+
+#define PS3204_MAX_ETS_CYCLES      125
+#define PS3204_MAX_ETS_INTERLEAVE   25
+
+#define PS3000_MAX_ETS_CYCLES_INTERLEAVE_RATIO  10
+#define PS3000_MIN_ETS_CYCLES_INTERLEAVE_RATIO   1
+#define PS300_MAX_ETS_SAMPLES 100000
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+#define MAX_HOLDOFF_COUNT 8388607L
+
+typedef enum enPS3000Channel
+{
+  PS3000_CHANNEL_A,
+  PS3000_CHANNEL_B,
+  PS3000_CHANNEL_C,
+  PS3000_CHANNEL_D,
+  PS3000_EXTERNAL,
+  PS3000_MAX_CHANNELS = PS3000_EXTERNAL,
+  PS3000_NONE,
+  PS3000_MAX_TRIGGER_SOURCES
+}  PS3000_CHANNEL;
+
+typedef enum enPS3000Range
+{
+  PS3000_10MV,
+  PS3000_20MV,
+  PS3000_50MV,
+  PS3000_100MV,
+  PS3000_200MV,
+  PS3000_500MV,
+  PS3000_1V,
+  PS3000_2V,
+  PS3000_5V,
+  PS3000_10V,
+  PS3000_20V,
+  PS3000_50V,
+  PS3000_100V,
+  PS3000_200V,
+  PS3000_400V,
+  PS3000_MAX_RANGES
+}  PS3000_RANGE;
+
+typedef enum enPS3000WaveTypes
+  {
+  PS3000_SQUARE,
+  PS3000_TRIANGLE,
+  PS3000_SINE,
+  PS3000_MAX_WAVE_TYPES
+  }  PS3000_WAVE_TYPES;
+
+typedef enum enPS3000TimeUnits
+  {
+  PS3000_FS,
+  PS3000_PS,
+  PS3000_NS,
+  PS3000_US,
+  PS3000_MS,
+  PS3000_S,
+  PS3000_MAX_TIME_UNITS,
+  }  PS3000_TIME_UNITS;
+
+typedef enum enPS3000Error
+  {
+  PS3000_OK,
+  PS3000_MAX_UNITS_OPENED,  // more than PS3000_MAX_UNITS
+  PS3000_MEM_FAIL,      //not enough RAM on host machine
+  PS3000_NOT_FOUND,      //cannot find device
+  PS3000_FW_FAIL,      //unabled to download firmware
+  PS3000_NOT_RESPONDING,
+  PS3000_CONFIG_FAIL,    //missing or corrupted configuration settings
+  PS3000_OS_NOT_SUPPORTED,  //need to use win98SE (or later) or win2k (or later)
+  PS3000_PICOPP_TOO_OLD,
+  }  PS3000_ERROR;
+
+typedef enum enPS3000Info
+{
+  PS3000_DRIVER_VERSION,
+  PS3000_USB_VERSION,
+  PS3000_HARDWARE_VERSION,
+  PS3000_VARIANT_INFO,
+  PS3000_BATCH_AND_SERIAL,
+  PS3000_CAL_DATE,
+  PS3000_ERROR_CODE,
+  PS3000_KERNEL_DRIVER_VERSION,
+  PS3000_DRIVER_PATH
+}  PS3000_INFO;
+
+typedef enum enPS3000TriggerDirection
+  {
+  PS3000_RISING,
+  PS3000_FALLING,
+  PS3000_MAX_DIRS
+  }  PS3000_TDIR;
+
+typedef enum enPS3000OpenProgress
+  {
+  PS3000_OPEN_PROGRESS_FAIL     = -1,
+  PS3000_OPEN_PROGRESS_PENDING  = 0,
+  PS3000_OPEN_PROGRESS_COMPLETE = 1
+  } PS3000_OPEN_PROGRESS;
+
+typedef enum enPS3000EtsMode
+  {
+  PS3000_ETS_OFF,                        // ETS disabled
+  PS3000_ETS_FAST,                       // Return ready as soon as requested no of interleaves is available
+  PS3000_ETS_SLOW,                        // Return ready every time a new set of no_of_cycles is collected
+  PS3000_ETS_MODES_MAX
+  }  PS3000_ETS_MODE;
+
+typedef int16_t (PREF4 *PS3000_CALLBACK_FUNC)
+(
+  int16_t *dataBuffer,
+  int16_t  noOfBuffers
+);
+
+typedef void (PREF4 *GetOverviewBuffersMaxMin)
+(
+  int16_t **overviewBuffers,
+  int16_t   overflow,
+  uint32_t  triggeredAt,
+  int16_t   triggered,
+  int16_t   auto_stop,
+  uint32_t  nValues
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_open_unit)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_get_unit_info)
+(
+  int16_t  handle,
+  int8_t  *string,
+  int16_t  string_length,
+  int16_t  line
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_flash_led)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_close_unit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_set_channel)
+(
+  int16_t  handle,
+  int16_t  channel,
+  int16_t  enabled,
+  int16_t  dc,
+  int16_t  range
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_get_timebase)
+(
+  int16_t  handle,
+  int16_t  timebase,
+  int32_t  no_of_samples,
+  int32_t *time_interval,
+  int16_t *time_units,
+  int16_t  oversample,
+  int32_t *max_samples
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps3000_set_siggen)
+(
+  int16_t  handle,
+  int16_t  wave_type,
+  int32_t  start_frequency,
+  int32_t  stop_frequency,
+  float    increment,
+  int16_t  dwell_time,
+  int16_t  repeat,
+  int16_t  dual_slope
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps3000_set_ets)
+(
+  int16_t  handle,
+  int16_t  mode,
+  int16_t  ets_cycles,
+  int16_t  ets_interleave
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_set_trigger)
+(
+  int16_t  handle,
+  int16_t  source,
+  int16_t  threshold,
+  int16_t  direction,
+  int16_t  delay,
+  int16_t  auto_trigger_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_set_trigger2)
+(
+  int16_t  handle,
+  int16_t  source,
+  int16_t  threshold,
+  int16_t  direction,
+  float    delay,
+  int16_t  auto_trigger_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_run_block)
+(
+  int16_t handle,
+  int32_t  no_of_values,
+  int16_t  timebase,
+  int16_t  oversample,
+  int32_t * time_indisposed_ms
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_run_streaming_ns)
+(
+  int16_t            handle,
+  uint32_t           sample_interval,
+  PS3000_TIME_UNITS  time_units,
+  uint32_t           max_samples,
+  int16_t            auto_stop,
+  uint32_t           noOfSamplesPerAggregate,
+  uint32_t           overview_buffer_size
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_run_streaming)
+(
+  int16_t  handle,
+  int16_t  sample_interval_ms,
+  int32_t  max_samples,
+  int16_t  windowed
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_ready)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_stop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps3000_get_values)
+(
+  int16_t  handle,
+  int16_t *buffer_a,
+  int16_t *buffer_b,
+  int16_t *buffer_c,
+  int16_t *buffer_d,
+  int16_t *overflow,
+  int32_t  no_of_values
+);
+
+PREF0 PREF1 void PREF2 PREF3 (ps3000_release_stream_buffer)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(ps3000_get_times_and_values)
+(
+  int16_t  handle,
+  int32_t *times,
+  int16_t *buffer_a,
+  int16_t *buffer_b,
+  int16_t *buffer_c,
+  int16_t *buffer_d,
+  int16_t *overflow,
+  int16_t  time_units,
+  int32_t  no_of_values
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_open_unit_async)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_open_unit_progress)
+(
+  int16_t *handle,
+  int16_t * progress_percent
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_streaming_ns_get_interval_stateless)
+(
+  int16_t   handle,
+  int16_t   nChannels,
+  uint32_t *sample_interval
+  );
+
+PREF0 PREF1 int16_t PREF2 PREF3(ps3000_get_streaming_last_values)
+(
+  int16_t                   handle,
+  GetOverviewBuffersMaxMin  lpGetOverviewBuffersMaxMin
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000_overview_buffer_status)
+(
+  int16_t  handle,
+  int16_t *previous_buffer_overrun
+);
+
+PREF0 PREF1 uint32_t PREF2 PREF3(ps3000_get_streaming_values)
+(
+  int16_t handle,
+  double *start_time,
+  int16_t  *pbuffer_a_max,
+  int16_t  *pbuffer_a_min,
+  int16_t  *pbuffer_b_max,
+  int16_t  *pbuffer_b_min,
+  int16_t  *pbuffer_c_max,
+  int16_t  *pbuffer_c_min,
+  int16_t  *pbuffer_d_max,
+  int16_t  *pbuffer_d_min,
+  int16_t  *overflow,
+  uint32_t *triggerAt,
+  int16_t  *triggered,
+  uint32_t  no_of_values,
+  uint32_t  noOfSamplesPerAggregate
+);
+
+PREF0 PREF1 uint32_t PREF2 PREF3 (ps3000_get_streaming_values_no_aggregation)
+(
+  int16_t   handle,
+  double   *start_time,
+  int16_t  *pbuffer_a,
+  int16_t  *pbuffer_b,
+  int16_t  *pbuffer_c,
+  int16_t  *pbuffer_d,
+  int16_t  *overflow,
+  uint32_t *triggerAt,
+  int16_t  *trigger,
+  uint32_t  no_of_values
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000_save_streaming_data)
+(
+  int16_t               handle,
+  PS3000_CALLBACK_FUNC  lpCallbackFunc,
+  int16_t              *dataBuffers,
+  int16_t               dataBufferSize
+);
+
+//===========================================================
+// Adv Trigger
+//===========================================================
+typedef enum enThresholdDirection
+{
+  ABOVE,
+  BELOW,
+  RISING,
+  FALLING,
+  RISING_OR_FALLING,
+  INSIDE = ABOVE,
+  OUTSIDE = BELOW,
+  ENTER = RISING,
+  EXIT = FALLING,
+  ENTER_OR_EXIT = RISING_OR_FALLING,
+  NONE = RISING
+} THRESHOLD_DIRECTION;
+
+typedef enum enThresholdMode
+{
+  LEVEL,
+  WINDOW
+} THRESHOLD_MODE;
+
+typedef enum enTriggerState
+{
+  CONDITION_DONT_CARE,
+  CONDITION_TRUE,
+  CONDITION_FALSE,
+  CONDITION_MAX
+} TRIGGER_STATE;
+
+typedef enum enPulseWidthType
+{
+  PW_TYPE_NONE,
+  PW_TYPE_LESS_THAN,
+  PW_TYPE_GREATER_THAN,
+  PW_TYPE_IN_RANGE,
+  PW_TYPE_OUT_OF_RANGE
+} PULSE_WIDTH_TYPE;
+
+#pragma pack(1)
+typedef struct tTriggerChannelProperties
+{
+  int16_t thresholdMajor;
+  int16_t thresholdMinor;
+  uint16_t hysteresis;
+  int16_t channel;
+  THRESHOLD_MODE thresholdMode;
+} TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tTriggerConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+  TRIGGER_STATE pulseWidthQualifier;
+} TRIGGER_CONDITIONS;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tPwqConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+} PWQ_CONDITIONS;
+#pragma pack()
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000SetAdvTriggerChannelProperties)
+(
+  int16_t                     handle,
+  TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                     nChannelProperties,
+  int32_t                     autoTriggerMilliseconds
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000SetAdvTriggerChannelConditions)
+(
+  int16_t              handle,
+  TRIGGER_CONDITIONS  *conditions,
+  int16_t              nConditions
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000SetAdvTriggerChannelDirections)
+(
+  int16_t              handle,
+  THRESHOLD_DIRECTION  channelA,
+  THRESHOLD_DIRECTION  channelB,
+  THRESHOLD_DIRECTION  channelC,
+  THRESHOLD_DIRECTION  channelD,
+  THRESHOLD_DIRECTION  ext
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000SetPulseWidthQualifier)
+(
+  int16_t              handle,
+  PWQ_CONDITIONS      *conditions,
+  int16_t              nConditions,
+  THRESHOLD_DIRECTION  direction,
+  uint32_t             lower,
+  uint32_t             upper,
+  PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000SetAdvTriggerDelay)
+(
+  int16_t   handle,
+  uint32_t  delay,
+  float     preTriggerDelay
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3 (ps3000PingUnit)
+  (
+  int16_t  handle
+  );
+
+#endif /* not defined PS3000_H */

+ 1142 - 0
pico-tcp-service/pico-tcp/inc/ps3000aApi.h

@@ -0,0 +1,1142 @@
+/****************************************************************************
+ *
+ * Filename:    ps3000aApi.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *	PicoScope 3000A, B and D Series PC Oscilloscopes.
+ *
+ * Copyright � 2010 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS3000AAPI_H__
+#define __PS3000AAPI_H__
+
+#include <stdint.h>
+
+#include "PicoCallback.h"
+#include "PicoStatus.h"
+#include "PicoVersion.h"
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+  #define TYPE_ENUM
+#else
+  #define PREF0
+  #define TYPE_ENUM enum
+#endif
+
+#ifdef WIN32
+  #ifdef PREF1
+    #undef PREF1
+  #endif
+  #ifdef PREF2
+    #undef PREF2
+  #endif
+  #ifdef PREF3
+    #undef PREF3
+  #endif
+  //If you are dynamically linking ps3000a.dll into your project #define DYNLINK here
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define __stdcall
+#endif
+
+#define PS3000A_MAX_OVERSAMPLE  256
+
+/* Depending on the adc;oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+
+#define PS3207A_MAX_ETS_CYCLES  500
+#define PS3207A_MAX_INTERLEAVE   40
+
+#define PS3206A_MAX_ETS_CYCLES  500
+#define PS3206A_MAX_INTERLEAVE   40
+#define PS3206MSO_MAX_INTERLEAVE 80
+
+#define PS3205A_MAX_ETS_CYCLES  250
+#define PS3205A_MAX_INTERLEAVE   20
+#define PS3205MSO_MAX_INTERLEAVE 40
+
+#define PS3204A_MAX_ETS_CYCLES  125
+#define PS3204A_MAX_INTERLEAVE   10
+#define PS3204MSO_MAX_INTERLEAVE 20
+
+#define PS3000A_EXT_MAX_VALUE  32767
+#define PS3000A_EXT_MIN_VALUE -32767
+
+#define PS3000A_MAX_LOGIC_LEVEL  32767
+#define PS3000A_MIN_LOGIC_LEVEL -32767
+
+#define MIN_SIG_GEN_FREQ 0.0f
+#define MAX_SIG_GEN_FREQ 20000000.0f
+
+#define PS3207B_MAX_SIG_GEN_BUFFER_SIZE 32768
+#define PS3206B_MAX_SIG_GEN_BUFFER_SIZE 16384
+#define MAX_SIG_GEN_BUFFER_SIZE         8192
+#define MIN_SIG_GEN_BUFFER_SIZE         1
+#define MIN_DWELL_COUNT                 3
+#define MAX_SWEEPS_SHOTS       ((1 << 30) - 1)
+
+#define MAX_ANALOGUE_OFFSET_50MV_200MV  0.250f
+#define MIN_ANALOGUE_OFFSET_50MV_200MV -0.250f
+#define MAX_ANALOGUE_OFFSET_500MV_2V    2.500f
+#define MIN_ANALOGUE_OFFSET_500MV_2V   -2.500f
+#define MAX_ANALOGUE_OFFSET_5V_20V        20.f
+#define MIN_ANALOGUE_OFFSET_5V_20V       -20.f
+
+#define PS3000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN 0xFFFFFFFF
+
+typedef enum enPS3000ABandwidthLimiter
+{
+  PS3000A_BW_FULL,
+  PS3000A_BW_20MHZ,
+} PS3000A_BANDWIDTH_LIMITER;
+
+typedef enum enPS3000AChannelBufferIndex
+{
+  PS3000A_CHANNEL_A_MAX,
+  PS3000A_CHANNEL_A_MIN,
+  PS3000A_CHANNEL_B_MAX,
+  PS3000A_CHANNEL_B_MIN,
+  PS3000A_CHANNEL_C_MAX,
+  PS3000A_CHANNEL_C_MIN,
+  PS3000A_CHANNEL_D_MAX,
+  PS3000A_CHANNEL_D_MIN,
+  PS3000A_MAX_CHANNEL_BUFFERS
+} PS3000A_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS3000AChannel
+{
+  PS3000A_CHANNEL_A,
+  PS3000A_CHANNEL_B,
+  PS3000A_CHANNEL_C,
+  PS3000A_CHANNEL_D,
+  PS3000A_EXTERNAL,
+  PS3000A_MAX_CHANNELS = PS3000A_EXTERNAL,
+  PS3000A_TRIGGER_AUX,
+  PS3000A_MAX_TRIGGER_SOURCES
+} PS3000A_CHANNEL;
+
+typedef enum enPS3000ADigitalPort
+{
+  PS3000A_DIGITAL_PORT0 = 0x80, // digital channel 0 - 7
+  PS3000A_DIGITAL_PORT1,             // digital channel 8 - 15
+  PS3000A_DIGITAL_PORT2,             // digital channel 16 - 23
+  PS3000A_DIGITAL_PORT3,             // digital channel 24 - 31
+  PS3000A_MAX_DIGITAL_PORTS = (PS3000A_DIGITAL_PORT3 - PS3000A_DIGITAL_PORT0) + 1
+} PS3000A_DIGITAL_PORT;
+
+typedef enum enPS3000ADigitalChannel
+{
+  PS3000A_DIGITAL_CHANNEL_0,
+  PS3000A_DIGITAL_CHANNEL_1,
+  PS3000A_DIGITAL_CHANNEL_2,
+  PS3000A_DIGITAL_CHANNEL_3,
+  PS3000A_DIGITAL_CHANNEL_4,
+  PS3000A_DIGITAL_CHANNEL_5,
+  PS3000A_DIGITAL_CHANNEL_6,
+  PS3000A_DIGITAL_CHANNEL_7,
+  PS3000A_DIGITAL_CHANNEL_8,
+  PS3000A_DIGITAL_CHANNEL_9,
+  PS3000A_DIGITAL_CHANNEL_10,
+  PS3000A_DIGITAL_CHANNEL_11,
+  PS3000A_DIGITAL_CHANNEL_12,
+  PS3000A_DIGITAL_CHANNEL_13,
+  PS3000A_DIGITAL_CHANNEL_14,
+  PS3000A_DIGITAL_CHANNEL_15,
+  PS3000A_DIGITAL_CHANNEL_16,
+  PS3000A_DIGITAL_CHANNEL_17,
+  PS3000A_DIGITAL_CHANNEL_18,
+  PS3000A_DIGITAL_CHANNEL_19,
+  PS3000A_DIGITAL_CHANNEL_20,
+  PS3000A_DIGITAL_CHANNEL_21,
+  PS3000A_DIGITAL_CHANNEL_22,
+  PS3000A_DIGITAL_CHANNEL_23,
+  PS3000A_DIGITAL_CHANNEL_24,
+  PS3000A_DIGITAL_CHANNEL_25,
+  PS3000A_DIGITAL_CHANNEL_26,
+  PS3000A_DIGITAL_CHANNEL_27,
+  PS3000A_DIGITAL_CHANNEL_28,
+  PS3000A_DIGITAL_CHANNEL_29,
+  PS3000A_DIGITAL_CHANNEL_30,
+  PS3000A_DIGITAL_CHANNEL_31,
+  PS3000A_MAX_DIGITAL_CHANNELS
+} PS3000A_DIGITAL_CHANNEL;
+
+typedef enum enPS3000ARange
+{
+  PS3000A_10MV,
+  PS3000A_20MV,
+  PS3000A_50MV,
+  PS3000A_100MV,
+  PS3000A_200MV,
+  PS3000A_500MV,
+  PS3000A_1V,
+  PS3000A_2V,
+  PS3000A_5V,
+  PS3000A_10V,
+  PS3000A_20V,
+  PS3000A_50V,
+  PS3000A_MAX_RANGES,
+} PS3000A_RANGE;
+
+typedef enum enPS3000ACoupling
+{
+  PS3000A_AC,
+  PS3000A_DC
+} PS3000A_COUPLING;
+
+typedef enum enPS3000AChannelInfo
+{
+  PS3000A_CI_RANGES,
+} PS3000A_CHANNEL_INFO;
+
+typedef enum enPS3000AEtsMode
+{
+  PS3000A_ETS_OFF, // ETS disabled
+  PS3000A_ETS_FAST,
+  PS3000A_ETS_SLOW,
+  PS3000A_ETS_MODES_MAX
+} PS3000A_ETS_MODE;
+
+typedef enum enPS3000ATimeUnits
+{
+  PS3000A_FS,
+  PS3000A_PS,
+  PS3000A_NS,
+  PS3000A_US,
+  PS3000A_MS,
+  PS3000A_S,
+  PS3000A_MAX_TIME_UNITS,
+} PS3000A_TIME_UNITS;
+
+typedef enum enPS3000ASweepType
+{
+  PS3000A_UP,
+  PS3000A_DOWN,
+  PS3000A_UPDOWN,
+  PS3000A_DOWNUP,
+  PS3000A_MAX_SWEEP_TYPES
+} PS3000A_SWEEP_TYPE;
+
+typedef enum enPS3000AWaveType
+{
+  PS3000A_SINE,
+  PS3000A_SQUARE,
+  PS3000A_TRIANGLE,
+  PS3000A_RAMP_UP,
+  PS3000A_RAMP_DOWN,
+  PS3000A_SINC,
+  PS3000A_GAUSSIAN,
+  PS3000A_HALF_SINE,
+  PS3000A_DC_VOLTAGE,
+  PS3000A_MAX_WAVE_TYPES
+} PS3000A_WAVE_TYPE;
+
+typedef enum enPS3000AExtraOperations
+{
+  PS3000A_ES_OFF,
+  PS3000A_WHITENOISE,
+  PS3000A_PRBS // Pseudo-Random Bit Stream
+} PS3000A_EXTRA_OPERATIONS;
+
+#define PS3000A_SINE_MAX_FREQUENCY       1000000.f
+#define PS3000A_SQUARE_MAX_FREQUENCY     1000000.f
+#define PS3000A_TRIANGLE_MAX_FREQUENCY   1000000.f
+#define PS3000A_SINC_MAX_FREQUENCY       1000000.f
+#define PS3000A_RAMP_MAX_FREQUENCY       1000000.f
+#define PS3000A_HALF_SINE_MAX_FREQUENCY  1000000.f
+#define PS3000A_GAUSSIAN_MAX_FREQUENCY   1000000.f
+#define PS3000A_PRBS_MAX_FREQUENCY       1000000.f
+#define PS3000A_PRBS_MIN_FREQUENCY           0.03f
+#define PS3000A_MIN_FREQUENCY                0.03f
+
+typedef enum enPS3000ASigGenTrigType
+{
+  PS3000A_SIGGEN_RISING,
+  PS3000A_SIGGEN_FALLING,
+  PS3000A_SIGGEN_GATE_HIGH,
+  PS3000A_SIGGEN_GATE_LOW
+} PS3000A_SIGGEN_TRIG_TYPE;
+
+typedef enum enPS3000ASigGenTrigSource
+{
+  PS3000A_SIGGEN_NONE,
+  PS3000A_SIGGEN_SCOPE_TRIG,
+  PS3000A_SIGGEN_AUX_IN,
+  PS3000A_SIGGEN_EXT_IN,
+  PS3000A_SIGGEN_SOFT_TRIG
+} PS3000A_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPS3000AIndexMode
+{
+  PS3000A_SINGLE,
+  PS3000A_DUAL,
+  PS3000A_QUAD,
+  PS3000A_MAX_INDEX_MODES
+} PS3000A_INDEX_MODE;
+
+typedef enum enPS3000A_ThresholdMode
+{
+  PS3000A_LEVEL,
+  PS3000A_WINDOW
+} PS3000A_THRESHOLD_MODE;
+
+typedef enum enPS3000AThresholdDirection
+{
+  PS3000A_ABOVE,             //using upper threshold
+  PS3000A_BELOW,						 //using upper threshold
+  PS3000A_RISING,            // using upper threshold
+  PS3000A_FALLING,           // using upper threshold
+  PS3000A_RISING_OR_FALLING, // using both threshold
+  PS3000A_ABOVE_LOWER,       // using lower threshold
+  PS3000A_BELOW_LOWER,       // using lower threshold
+  PS3000A_RISING_LOWER,      // using lower threshold
+  PS3000A_FALLING_LOWER,     // using lower threshold
+  // Windowing using both thresholds
+  PS3000A_INSIDE        = PS3000A_ABOVE,
+  PS3000A_OUTSIDE       = PS3000A_BELOW,
+  PS3000A_ENTER         = PS3000A_RISING,
+  PS3000A_EXIT          = PS3000A_FALLING,
+  PS3000A_ENTER_OR_EXIT = PS3000A_RISING_OR_FALLING,
+  PS3000A_POSITIVE_RUNT = 9,
+  PS3000A_NEGATIVE_RUNT,
+  // no trigger set
+  PS3000A_NONE = PS3000A_RISING
+} PS3000A_THRESHOLD_DIRECTION;
+
+typedef enum enPS3000ADigitalDirection
+{
+  PS3000A_DIGITAL_DONT_CARE,
+  PS3000A_DIGITAL_DIRECTION_LOW,
+  PS3000A_DIGITAL_DIRECTION_HIGH,
+  PS3000A_DIGITAL_DIRECTION_RISING,
+  PS3000A_DIGITAL_DIRECTION_FALLING,
+  PS3000A_DIGITAL_DIRECTION_RISING_OR_FALLING,
+  PS3000A_DIGITAL_MAX_DIRECTION
+} PS3000A_DIGITAL_DIRECTION;
+
+typedef enum enPS3000ATriggerState
+{
+  PS3000A_CONDITION_DONT_CARE,
+  PS3000A_CONDITION_TRUE,
+  PS3000A_CONDITION_FALSE,
+  PS3000A_CONDITION_MAX
+} PS3000A_TRIGGER_STATE;
+
+#pragma pack(push,1)
+typedef struct tPS3000ATriggerConditions
+{
+  PS3000A_TRIGGER_STATE channelA;
+  PS3000A_TRIGGER_STATE channelB;
+  PS3000A_TRIGGER_STATE channelC;
+  PS3000A_TRIGGER_STATE channelD;
+  PS3000A_TRIGGER_STATE external;
+  PS3000A_TRIGGER_STATE aux;
+  PS3000A_TRIGGER_STATE pulseWidthQualifier;
+} PS3000A_TRIGGER_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000ATriggerConditionsV2
+{
+  PS3000A_TRIGGER_STATE channelA;
+  PS3000A_TRIGGER_STATE channelB;
+  PS3000A_TRIGGER_STATE channelC;
+  PS3000A_TRIGGER_STATE channelD;
+  PS3000A_TRIGGER_STATE external;
+  PS3000A_TRIGGER_STATE aux;
+  PS3000A_TRIGGER_STATE pulseWidthQualifier;
+  PS3000A_TRIGGER_STATE digital;
+} PS3000A_TRIGGER_CONDITIONS_V2;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000APwqConditions
+{
+  PS3000A_TRIGGER_STATE channelA;
+  PS3000A_TRIGGER_STATE channelB;
+  PS3000A_TRIGGER_STATE channelC;
+  PS3000A_TRIGGER_STATE channelD;
+  PS3000A_TRIGGER_STATE external;
+  PS3000A_TRIGGER_STATE aux;
+} PS3000A_PWQ_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000APwqConditionsV2
+{
+  PS3000A_TRIGGER_STATE channelA;
+  PS3000A_TRIGGER_STATE channelB;
+  PS3000A_TRIGGER_STATE channelC;
+  PS3000A_TRIGGER_STATE channelD;
+  PS3000A_TRIGGER_STATE external;
+  PS3000A_TRIGGER_STATE aux;
+  PS3000A_TRIGGER_STATE digital;
+} PS3000A_PWQ_CONDITIONS_V2;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000ADigitalChannelDirections
+{
+  PS3000A_DIGITAL_CHANNEL   channel;
+  PS3000A_DIGITAL_DIRECTION direction;
+} PS3000A_DIGITAL_CHANNEL_DIRECTIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000ATriggerChannelProperties
+{
+  int16_t                   thresholdUpper;
+  uint16_t          thresholdUpperHysteresis;
+  int16_t                   thresholdLower;
+  uint16_t          thresholdLowerHysteresis;
+  PS3000A_CHANNEL         channel;
+  PS3000A_THRESHOLD_MODE  thresholdMode;
+} PS3000A_TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000ATriggerInfo
+{
+	PICO_STATUS		status;
+	uint32_t		segmentIndex;
+	uint32_t		reserved0;
+	int64_t			triggerTime;
+	int16_t			timeUnits;
+	int16_t			reserved1;
+	uint64_t		timeStampCounter;
+} PS3000A_TRIGGER_INFO;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS3000AScalingFactors
+{
+	PS3000A_CHANNEL channelOrPort;
+	PS3000A_RANGE   range;
+	int16_t         offset;
+	double          scalingFactor;
+}PS3000A_SCALING_FACTORS_VALUES;
+#pragma pack(pop)
+
+typedef enum enPS3000ARatioMode
+{
+  PS3000A_RATIO_MODE_NONE,
+  PS3000A_RATIO_MODE_AGGREGATE = 1,
+  PS3000A_RATIO_MODE_DECIMATE  = 2,
+  PS3000A_RATIO_MODE_AVERAGE   = 4,
+} PS3000A_RATIO_MODE;
+
+typedef enum enPS3000APulseWidthType
+{
+  PS3000A_PW_TYPE_NONE,
+  PS3000A_PW_TYPE_LESS_THAN,
+  PS3000A_PW_TYPE_GREATER_THAN,
+  PS3000A_PW_TYPE_IN_RANGE,
+  PS3000A_PW_TYPE_OUT_OF_RANGE
+} PS3000A_PULSE_WIDTH_TYPE;
+
+typedef enum enPS3000AHoldOffType
+{
+  PS3000A_TIME,
+  PS3000A_EVENT,
+  PS3000A_MAX_HOLDOFF_TYPE
+} PS3000A_HOLDOFF_TYPE;
+
+typedef void (__stdcall *ps3000aBlockReady)
+(
+  int16_t       handle,
+  PICO_STATUS status,
+  void       *pParameter
+);
+
+typedef void (__stdcall *ps3000aStreamingReady)
+(
+  int16_t          handle,
+  int32_t           noOfSamples,
+  uint32_t  startIndex,
+  int16_t          overflow,
+  uint32_t  triggerAt,
+  int16_t          triggered,
+  int16_t          autoStop,
+  void          *pParameter
+);
+
+typedef void (__stdcall *ps3000aDataReady)
+(
+  int16_t          handle,
+  PICO_STATUS    status,
+  uint32_t  noOfSamples,
+  int16_t          overflow,
+  void          *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aOpenUnit)
+(
+  int16_t *handle,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aOpenUnitAsync)
+(
+  int16_t *status,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aOpenUnitProgress)
+(
+  int16_t *handle,
+  int16_t *progressPercent,
+  int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetUnitInfo)
+ (
+  int16_t      handle,
+  int8_t      *string,
+  int16_t      stringLength,
+  int16_t     *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aFlashLed)
+(
+  int16_t  handle,
+  int16_t  start
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aCloseUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aMemorySegments)
+(
+  int16_t           handle,
+  uint32_t  nSegments,
+  int32_t           *nMaxSamples
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetChannel)
+(
+  int16_t             handle,
+  PS3000A_CHANNEL   channel,
+  int16_t             enabled,
+  PS3000A_COUPLING  type,
+  PS3000A_RANGE     range,
+  float             analogOffset
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetDigitalPort)
+(
+  int16_t                 handle,
+  PS3000A_DIGITAL_PORT  port,
+  int16_t                 enabled,
+  int16_t                 logicLevel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetBandwidthFilter)
+(
+  int16_t                      handle,
+  PS3000A_CHANNEL            channel,
+  PS3000A_BANDWIDTH_LIMITER  bandwidth
+);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetNoOfCaptures)
+(
+  int16_t           handle,
+  uint32_t  nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetTimebase)
+(
+  int16_t           handle,
+  uint32_t   timebase,
+  int32_t            noSamples,
+  int32_t           *timeIntervalNanoseconds,
+  int16_t           oversample,
+  int32_t           *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetTimebase2)
+(
+  int16_t           handle,
+  uint32_t   timebase,
+  int32_t            noSamples,
+  float          *timeIntervalNanoseconds,
+  int16_t           oversample,
+  int32_t           *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetSigGenArbitrary)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  uint32_t               startDeltaPhase,
+  uint32_t               stopDeltaPhase,
+  uint32_t               deltaPhaseIncrement,
+  uint32_t               dwellCount,
+  int16_t                      *arbitraryWaveform,
+  int32_t                        arbitraryWaveformSize,
+  PS3000A_SWEEP_TYPE          sweepType,
+  PS3000A_EXTRA_OPERATIONS    operation,
+  PS3000A_INDEX_MODE          indexMode,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS3000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS3000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSetSigGenBuiltIn)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  int16_t                       waveType,
+  float                       startFrequency,
+  float                       stopFrequency,
+  float                       increment,
+  float                       dwellTime,
+  PS3000A_SWEEP_TYPE          sweepType,
+  PS3000A_EXTRA_OPERATIONS    operation,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS3000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS3000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSetSigGenBuiltInV2)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  int16_t                       waveType,
+  double                       startFrequency,
+  double                       stopFrequency,
+	double											 increment,
+  double                       dwellTime,
+  PS3000A_SWEEP_TYPE          sweepType,
+  PS3000A_EXTRA_OPERATIONS    operation,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS3000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS3000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetSigGenPropertiesArbitrary)
+(
+  int16_t                       handle,
+  uint32_t               startDeltaPhase,
+  uint32_t               stopDeltaPhase,
+  uint32_t               deltaPhaseIncrement,
+  uint32_t               dwellCount,
+  PS3000A_SWEEP_TYPE          sweepType,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS3000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS3000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSetSigGenPropertiesBuiltIn)
+(
+  int16_t                       handle,
+  double                       startFrequency,
+  double                       stopFrequency,
+  double                       increment,
+  double                       dwellTime,
+  PS3000A_SWEEP_TYPE          sweepType,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS3000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS3000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	PS3000A_INDEX_MODE						indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aGetMaxEtsValues)
+	(
+	int16_t			 handle,
+	int16_t    * etsCycles,
+	int16_t    * etsInterleave
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSigGenSoftwareControl)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetEts)
+(
+  int16_t             handle,
+  PS3000A_ETS_MODE  mode,
+  int16_t             etsCycles,
+  int16_t             etsInterleave,
+  int32_t             *sampleTimePicoseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetSimpleTrigger)
+(
+  int16_t                        handle,
+  int16_t                        enable,
+  PS3000A_CHANNEL              source,
+  int16_t                        threshold,
+  PS3000A_THRESHOLD_DIRECTION  direction,
+  uint32_t                delay,
+  int16_t                        autoTrigger_ms
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerDigitalPortProperties)
+(
+  int16_t                               handle,
+  PS3000A_DIGITAL_CHANNEL_DIRECTIONS *directions,
+  int16_t                               nDirections
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetPulseWidthDigitalPortProperties)
+	(
+	int16_t                               handle,
+	PS3000A_DIGITAL_CHANNEL_DIRECTIONS *directions,
+	int16_t                               nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerChannelProperties)
+(
+  int16_t                               handle,
+  PS3000A_TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                               nChannelProperties,
+  int16_t                               auxOutputEnable,
+  int32_t                                autoTriggerMilliseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerChannelConditions)
+(
+  int16_t                       handle,
+  PS3000A_TRIGGER_CONDITIONS *conditions,
+  int16_t                       nConditions
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerChannelConditionsV2)
+(
+  int16_t                          handle,
+  PS3000A_TRIGGER_CONDITIONS_V2 *conditions,
+  int16_t                          nConditions
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerChannelDirections)
+(
+  int16_t                        handle,
+  PS3000A_THRESHOLD_DIRECTION  channelA,
+  PS3000A_THRESHOLD_DIRECTION  channelB,
+  PS3000A_THRESHOLD_DIRECTION  channelC,
+  PS3000A_THRESHOLD_DIRECTION  channelD,
+  PS3000A_THRESHOLD_DIRECTION  ext,
+  PS3000A_THRESHOLD_DIRECTION  aux
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetTriggerDelay)
+(
+  int16_t          handle,
+  uint32_t  delay
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetPulseWidthQualifier)
+(
+  int16_t                        handle,
+  PS3000A_PWQ_CONDITIONS      *conditions,
+  int16_t                        nConditions,
+  PS3000A_THRESHOLD_DIRECTION  direction,
+  uint32_t                lower,
+  uint32_t                upper,
+  PS3000A_PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetPulseWidthQualifierV2)
+(
+  int16_t                        handle,
+  PS3000A_PWQ_CONDITIONS_V2   *conditions,
+  int16_t                        nConditions,
+  PS3000A_THRESHOLD_DIRECTION  direction,
+  uint32_t                lower,
+  uint32_t                upper,
+  PS3000A_PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aIsTriggerOrPulseWidthQualifierEnabled)
+(
+  int16_t  handle,
+  int16_t *triggerEnabled,
+  int16_t *pulseWidthQualifierEnabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetTriggerTimeOffset)
+(
+  int16_t               handle,
+  uint32_t      *timeUpper,
+  uint32_t      *timeLower,
+  PS3000A_TIME_UNITS *timeUnits,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetTriggerTimeOffset64)
+(
+  int16_t               handle,
+  int64_t            *time,
+  PS3000A_TIME_UNITS *timeUnits,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesTriggerTimeOffsetBulk)
+(
+  int16_t               handle,
+  uint32_t      *timesUpper,
+  uint32_t      *timesLower,
+  PS3000A_TIME_UNITS *timeUnits,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesTriggerTimeOffsetBulk64)
+(
+  int16_t               handle,
+  int64_t            *times,
+  PS3000A_TIME_UNITS *timeUnits,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetNoOfCaptures)
+(
+  int16_t          handle,
+  uint32_t *nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetNoOfProcessedCaptures)
+(
+  int16_t          handle,
+  uint32_t *nProcessedCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetDataBuffer)
+(
+  int16_t               handle,
+  PS3000A_CHANNEL     channelOrPort,
+  int16_t              *buffer,
+  int32_t                bufferLth,
+  uint32_t      segmentIndex,
+  PS3000A_RATIO_MODE  mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetDataBuffers)
+(
+  int16_t               handle,
+  PS3000A_CHANNEL     channelOrPort,
+  int16_t              *bufferMax,
+  int16_t              *bufferMin,
+  int32_t                bufferLth,
+  uint32_t      segmentIndex,
+  PS3000A_RATIO_MODE  mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSetUnscaledDataBuffers)
+(
+	int16_t               handle,
+	PS3000A_CHANNEL     channelOrPort,
+	int8_t              *bufferMax,
+	int8_t              *bufferMin,
+	int32_t                bufferLth,
+	uint32_t      segmentIndex,
+	PS3000A_RATIO_MODE  mode
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetEtsTimeBuffer)
+(
+  int16_t    handle,
+  int64_t *buffer,
+  int32_t     bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aSetEtsTimeBuffers)
+(
+  int16_t          handle,
+  uint32_t *timeUpper,
+  uint32_t *timeLower,
+  int32_t           bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aIsReady)
+(
+  int16_t  handle,
+  int16_t *ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aRunBlock)
+(
+  int16_t              handle,
+  int32_t               noOfPreTriggerSamples,
+  int32_t               noOfPostTriggerSamples,
+  uint32_t      timebase,
+  int16_t              oversample,
+  int32_t              *timeIndisposedMs,
+  uint32_t     segmentIndex,
+  ps3000aBlockReady  lpReady,
+  void              *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aRunStreaming)
+(
+  int16_t               handle,
+  uint32_t      *sampleInterval,
+  PS3000A_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t       maxPreTriggerSamples,
+  uint32_t       maxPostPreTriggerSamples,
+  int16_t               autoStop,
+  uint32_t       downSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetStreamingLatestValues)
+(
+int16_t                  handle,
+ps3000aStreamingReady  lpPs3000aReady,
+void                  *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aNoOfStreamingValues)
+(
+  int16_t          handle,
+  uint32_t *noOfValues
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetMaxDownSampleRatio)
+(
+  int16_t               handle,
+  uint32_t       noOfUnaggreatedSamples,
+  uint32_t      *maxDownSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValues)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesBulk)
+(
+ int16_t                handle,
+  uint32_t      *noOfSamples,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex,
+  uint32_t       downSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesAsync)
+(
+  int16_t           handle,
+  uint32_t   startIndex,
+  uint32_t   noOfSamples,
+  uint32_t   downSampleRatio,
+  PS3000A_RATIO_MODE   downSampleRatioMode,
+  uint32_t  segmentIndex,
+  void           *lpDataReady,
+  void           *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesOverlapped)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex,
+  int16_t              *overflow
+);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetValuesOverlappedBulk)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS3000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetTriggerInfoBulk)
+(
+	int16_t									handle,
+  PS3000A_TRIGGER_INFO	*	triggerInfo,
+  uint32_t								fromSegmentIndex,
+  uint32_t								toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aStop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aHoldOff)
+(
+  int16_t                 handle,
+  uint64_t             holdoff,
+  PS3000A_HOLDOFF_TYPE  type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetChannelInformation)
+(
+  int16_t                 handle,
+  PS3000A_CHANNEL_INFO  info,
+  int32_t                   probe,
+  int32_t                  *ranges,
+  int32_t                  *length,
+  int32_t                   channels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aEnumerateUnits)
+(
+  int16_t *count,
+  int8_t  *serials,
+  int16_t *serialLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aPingUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aMaximumValue)
+(
+  int16_t  handle,
+  int16_t *value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aMinimumValue)
+(
+  int16_t  handle,
+  int16_t *value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetAnalogueOffset)
+(
+  int16_t             handle,
+  PS3000A_RANGE     range,
+  PS3000A_COUPLING  coupling,
+  float            *maximumVoltage,
+  float            *minimumVoltage
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aGetMaxSegments)
+(
+  int16_t           handle,
+  uint32_t *maxSegments
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aChangePowerSource)
+(
+  int16_t        handle,
+  PICO_STATUS  powerState
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps3000aCurrentPowerSource)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aGetScalingValues)
+(
+	int16_t	handle,
+	PS3000A_SCALING_FACTORS_VALUES *scalingValues,
+	int16_t nChannels
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aCheckForUpdate)(int16_t handle,
+                                                           PICO_FIRMWARE_INFO* firmwareInfos,
+                                                           int16_t* nFirmwareInfos,
+                                                           uint16_t* updatesRequired);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps3000aStartFirmwareUpdate)(int16_t handle, PicoUpdateFirmwareProgress progress);
+
+#endif

+ 979 - 0
pico-tcp-service/pico-tcp/inc/ps4000Api.h

@@ -0,0 +1,979 @@
+/****************************************************************************
+ *
+ * Filename:    ps4000Api.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 4000 Series PC Oscilloscopes.
+ *
+ * Copyright � 2008 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS4000API_H__
+#define __PS4000API_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+  #define TYPE_ENUM
+#else
+  #define PREF0
+  #define TYPE_ENUM enum
+#endif
+
+#ifdef WIN32
+  typedef uint64_t uint64_t;
+  #ifdef PREF1
+    #undef PREF1
+  #endif
+  #ifdef PREF2
+    #undef PREF2
+  #endif
+  #ifdef PREF3
+    #undef PREF3
+  #endif
+  /*  If you are dynamically linking ps4000.dll into your project #define DYNLINK here
+   */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define __stdcall
+#endif
+
+#define PS4000_MAX_OVERSAMPLE_12BIT  16
+#define PS4000_MAX_OVERSAMPLE_8BIT  256
+
+/* Depending on the adc; oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+
+#define PS4XXX_MAX_ETS_CYCLES 400
+#define PS4XXX_MAX_INTERLEAVE  80
+
+#define PS4262_MAX_VALUE  32767
+#define PS4262_MIN_VALUE -32767
+
+#define PS4000_MAX_VALUE  32764
+#define PS4000_MIN_VALUE -32764
+#define PS4000_LOST_DATA -32768
+
+#define PS4000_EXT_MAX_VALUE  32767
+#define PS4000_EXT_MIN_VALUE -32767
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+#define MAX_DELAY_COUNT 8388607L
+
+#define MIN_SIG_GEN_FREQ          0.0f
+#define MAX_SIG_GEN_FREQ     100000.0f
+#define MAX_SIG_GEN_FREQ_4262 20000.0f
+
+// applicable to all variants with a signal generator
+#define MIN_SIG_GEN_BUFFER_SIZE    1
+
+// values relate to the PS4227 and PS4226
+#define MAX_SIG_GEN_BUFFER_SIZE 8192
+#define MIN_DWELL_COUNT           10
+
+#define PS4262_MAX_WAVEFORM_BUFFER_SIZE 4096
+#define PS4262_MIN_DWELL_COUNT             3
+
+#define MAX_SWEEPS_SHOTS     ((1 << 30) - 1)
+
+typedef enum enChannelBufferIndex
+{
+  PS4000_CHANNEL_A_MAX,
+  PS4000_CHANNEL_A_MIN,
+  PS4000_CHANNEL_B_MAX,
+  PS4000_CHANNEL_B_MIN,
+  PS4000_CHANNEL_C_MAX,
+  PS4000_CHANNEL_C_MIN,
+  PS4000_CHANNEL_D_MAX,
+  PS4000_CHANNEL_D_MIN,
+  PS4000_MAX_CHANNEL_BUFFERS
+} PS4000_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS4000Channel
+{
+  PS4000_CHANNEL_A,
+  PS4000_CHANNEL_B,
+  PS4000_CHANNEL_C,
+  PS4000_CHANNEL_D,
+  PS4000_EXTERNAL,
+  PS4000_MAX_CHANNELS = PS4000_EXTERNAL,
+  PS4000_TRIGGER_AUX,
+  PS4000_MAX_TRIGGER_SOURCES
+}  PS4000_CHANNEL;
+
+typedef enum enPS4000Range
+{
+  PS4000_10MV,
+  PS4000_20MV,
+  PS4000_50MV,
+  PS4000_100MV,
+  PS4000_200MV,
+  PS4000_500MV,
+  PS4000_1V,
+  PS4000_2V,
+  PS4000_5V,
+  PS4000_10V,
+  PS4000_20V,
+  PS4000_50V,
+  PS4000_100V,
+  PS4000_MAX_RANGES,
+
+  PS4000_RESISTANCE_100R = PS4000_MAX_RANGES,
+  PS4000_RESISTANCE_1K,
+  PS4000_RESISTANCE_10K,
+  PS4000_RESISTANCE_100K,
+  PS4000_RESISTANCE_1M,
+  PS4000_MAX_RESISTANCES,
+
+  PS4000_ACCELEROMETER_10MV = PS4000_MAX_RESISTANCES,
+  PS4000_ACCELEROMETER_20MV,
+  PS4000_ACCELEROMETER_50MV,
+  PS4000_ACCELEROMETER_100MV,
+  PS4000_ACCELEROMETER_200MV,
+  PS4000_ACCELEROMETER_500MV,
+  PS4000_ACCELEROMETER_1V,
+  PS4000_ACCELEROMETER_2V,
+  PS4000_ACCELEROMETER_5V,
+  PS4000_ACCELEROMETER_10V,
+  PS4000_ACCELEROMETER_20V,
+  PS4000_ACCELEROMETER_50V,
+  PS4000_ACCELEROMETER_100V,
+  PS4000_MAX_ACCELEROMETER,
+
+  PS4000_TEMPERATURE_UPTO_40 = PS4000_MAX_ACCELEROMETER,
+  PS4000_TEMPERATURE_UPTO_70,
+  PS4000_TEMPERATURE_UPTO_100,
+  PS4000_TEMPERATURE_UPTO_130,
+  PS4000_MAX_TEMPERATURES,
+
+  PS4000_RESISTANCE_5K = PS4000_MAX_TEMPERATURES,
+  PS4000_RESISTANCE_25K,
+  PS4000_RESISTANCE_50K,
+  PS4000_MAX_EXTRA_RESISTANCES
+} PS4000_RANGE;
+
+typedef enum enPS4000Probe
+{
+  P_NONE,
+  P_CURRENT_CLAMP_10A,
+  P_CURRENT_CLAMP_1000A,
+  P_TEMPERATURE_SENSOR,
+  P_CURRENT_MEASURING_DEVICE,
+  P_PRESSURE_SENSOR_50BAR,
+  P_PRESSURE_SENSOR_5BAR,
+  P_OPTICAL_SWITCH,
+  P_UNKNOWN,
+  P_MAX_PROBES = P_UNKNOWN
+} PS4000_PROBE;
+
+typedef enum enPS4000ChannelInfo
+{
+  CI_RANGES,
+  CI_RESISTANCES,
+  CI_ACCELEROMETER,
+  CI_PROBES,
+  CI_TEMPERATURES
+} PS4000_CHANNEL_INFO;
+
+typedef enum enPS4000EtsMode
+  {
+  PS4000_ETS_OFF,             // ETS disabled
+  PS4000_ETS_FAST,
+  PS4000_ETS_SLOW,
+  PS4000_ETS_MODES_MAX
+  }  PS4000_ETS_MODE;
+
+typedef enum enPS4000TimeUnits
+  {
+  PS4000_FS,
+  PS4000_PS,
+  PS4000_NS,
+  PS4000_US,
+  PS4000_MS,
+  PS4000_S,
+  PS4000_MAX_TIME_UNITS,
+  }  PS4000_TIME_UNITS;
+
+typedef enum enSweepType
+{
+  UP,
+  DOWN,
+  UPDOWN,
+  DOWNUP,
+  MAX_SWEEP_TYPES
+} SWEEP_TYPE;
+
+typedef enum enPS4000OperationTypes
+{
+  PS4000_OP_NONE,
+  PS4000_WHITENOISE,
+  PS4000_PRBS
+} PS4000_OPERATION_TYPES;
+
+typedef enum enWaveType
+{
+  PS4000_SINE,
+  PS4000_SQUARE,
+  PS4000_TRIANGLE,
+  PS4000_RAMP_UP,
+  PS4000_RAMP_DOWN,
+  PS4000_SINC,
+  PS4000_GAUSSIAN,
+  PS4000_HALF_SINE,
+  PS4000_DC_VOLTAGE,
+  PS4000_WHITE_NOISE,
+  MAX_WAVE_TYPES
+} WAVE_TYPE;
+
+typedef enum enSigGenTrigType
+{
+  SIGGEN_RISING,
+  SIGGEN_FALLING,
+  SIGGEN_GATE_HIGH,
+  SIGGEN_GATE_LOW
+} SIGGEN_TRIG_TYPE;
+
+typedef enum enSigGenTrigSource
+{
+  SIGGEN_NONE,
+  SIGGEN_SCOPE_TRIG,
+  SIGGEN_AUX_IN,
+  SIGGEN_EXT_IN,
+  SIGGEN_SOFT_TRIG
+} SIGGEN_TRIG_SOURCE;
+
+typedef enum enIndexMode
+{
+  SINGLE,
+  DUAL,
+  QUAD,
+  MAX_INDEX_MODES
+} INDEX_MODE;
+
+typedef enum enThresholdMode
+{
+  LEVEL,
+  WINDOW
+} THRESHOLD_MODE;
+
+typedef enum enThresholdDirection
+{
+  ABOVE, //using upper threshold
+  BELOW,
+  RISING, // using upper threshold
+  FALLING, // using upper threshold
+  RISING_OR_FALLING, // using both threshold
+  ABOVE_LOWER, // using lower threshold
+  BELOW_LOWER, // using lower threshold
+  RISING_LOWER,       // using lower threshold
+  FALLING_LOWER,     // using lower threshold
+
+  // Windowing using both thresholds
+  INSIDE = ABOVE,
+  OUTSIDE = BELOW,
+  ENTER = RISING,
+  EXIT = FALLING,
+  ENTER_OR_EXIT = RISING_OR_FALLING,
+  POSITIVE_RUNT = 9,
+  NEGATIVE_RUNT,
+
+  // no trigger set
+  NONE = RISING
+} THRESHOLD_DIRECTION;
+
+typedef enum enTriggerState
+{
+  CONDITION_DONT_CARE,
+  CONDITION_TRUE,
+  CONDITION_FALSE,
+  CONDITION_MAX
+} TRIGGER_STATE;
+
+#pragma pack(1)
+typedef struct tTriggerConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+  TRIGGER_STATE aux;
+  TRIGGER_STATE pulseWidthQualifier;
+} TRIGGER_CONDITIONS;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tPwqConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+  TRIGGER_STATE aux;
+} PWQ_CONDITIONS;
+#pragma pack()
+
+#pragma pack(1)
+typedef struct tTriggerChannelProperties
+{
+  int16_t thresholdUpper;
+  uint16_t thresholdUpperHysteresis;
+  int16_t thresholdLower;
+  uint16_t thresholdLowerHysteresis;
+  PS4000_CHANNEL channel;
+  THRESHOLD_MODE thresholdMode;
+} TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack()
+
+typedef enum enRatioMode
+{
+  RATIO_MODE_NONE,
+  RATIO_MODE_AGGREGATE = 1,
+  RATIO_MODE_AVERAGE = 2
+} RATIO_MODE;
+
+typedef enum enPulseWidthType
+{
+  PW_TYPE_NONE,
+  PW_TYPE_LESS_THAN,
+  PW_TYPE_GREATER_THAN,
+  PW_TYPE_IN_RANGE,
+  PW_TYPE_OUT_OF_RANGE
+} PULSE_WIDTH_TYPE;
+
+typedef enum enPs4000HoldOffType
+{
+  PS4000_TIME,
+  PS4000_MAX_HOLDOFF_TYPE
+} PS4000_HOLDOFF_TYPE;
+
+typedef enum enPS4000FrequencyCounterRange
+{
+  FC_2K,
+  FC_20K,
+  FC_20,
+  FC_200,
+  FC_MAX
+}PS4000_FREQUENCY_COUNTER_RANGE;
+
+typedef void (__stdcall *ps4000BlockReady)
+(
+  int16_t      handle,
+  PICO_STATUS  status,
+  void        *pParameter
+);
+
+typedef void (__stdcall *ps4000StreamingReady)
+(
+  int16_t   handle,
+  int32_t   noOfSamples,
+  uint32_t  startIndex,
+  int16_t   overflow,
+  uint32_t  triggerAt,
+  int16_t   triggered,
+  int16_t   autoStop,
+  void     *pParameter
+);
+
+typedef void (__stdcall *ps4000DataReady)
+(
+  int16_t   handle,
+  int32_t   noOfSamples,
+  int16_t   overflow,
+  uint32_t  triggerAt,
+  int16_t   triggered,
+  void     *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000OpenUnit)
+(
+  int16_t *handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000OpenUnitAsync)
+(
+  int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000OpenUnitEx)
+(
+  int16_t *handle,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000OpenUnitAsyncEx)
+(
+  int16_t *status,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000OpenUnitProgress)
+(
+  int16_t *handle,
+  int16_t *progressPercent,
+  int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetUnitInfo)
+(
+  int16_t    handle,
+  int8_t    *string,
+  int16_t    stringLength,
+  int16_t   *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000FlashLed)
+(
+  int16_t  handle,
+  int16_t  start
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000IsLedFlashing)
+(
+  int16_t  handle,
+  int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000CloseUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000MemorySegments)
+(
+  int16_t   handle,
+  uint16_t  nSegments,
+  int32_t  *nMaxSamples
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetChannel)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t         enabled,
+  int16_t         dc,
+  PS4000_RANGE    range
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetNoOfCaptures)
+(
+  int16_t   handle,
+  uint16_t  nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTimebase)
+(
+  int16_t   handle,
+  uint32_t  timebase,
+  int32_t   noSamples,
+  int32_t  *timeIntervalNanoseconds,
+  int16_t   oversample,
+  int32_t  *maxSamples,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTimebase2)
+(
+  int16_t   handle,
+  uint32_t  timebase,
+  int32_t   noSamples,
+  float    *timeIntervalNanoseconds,
+  int16_t   oversample,
+  int32_t  *maxSamples,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SigGenOff)
+(
+	int16_t handle
+);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetSigGenArbitrary)
+(
+  int16_t             handle,
+  int32_t             offsetVoltage,
+  uint32_t            pkToPk,
+  uint32_t            startDeltaPhase,
+  uint32_t            stopDeltaPhase,
+  uint32_t            deltaPhaseIncrement,
+  uint32_t            dwellCount,
+  int16_t            *arbitraryWaveform,
+  int32_t             arbitraryWaveformSize,
+  SWEEP_TYPE          sweepType,
+  int16_t             operationType,
+  INDEX_MODE          indexMode,
+  uint32_t            shots,
+  uint32_t            sweeps,
+  SIGGEN_TRIG_TYPE    triggerType,
+  SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t             extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000SetSigGenBuiltIn)
+(
+  int16_t             handle,
+  int32_t             offsetVoltage,
+  uint32_t            pkToPk,
+  int16_t             waveType,
+  float               startFrequency,
+  float               stopFrequency,
+  float               increment,
+  float               dwellTime,
+  SWEEP_TYPE          sweepType,
+  int16_t             operationType,
+  uint32_t            shots,
+  uint32_t            sweeps,
+  SIGGEN_TRIG_TYPE    triggerType,
+  SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t             extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000SigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	INDEX_MODE										indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000SigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SigGenSoftwareControl)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetEts)
+(
+  int16_t          handle,
+  PS4000_ETS_MODE  mode,
+  int16_t          etsCycles,
+  int16_t          etsInterleave,
+  int32_t         *sampleTimePicoseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetSimpleTrigger)
+(
+  int16_t handle,
+  int16_t enable,
+  PS4000_CHANNEL source,
+  int16_t threshold,
+  THRESHOLD_DIRECTION direction,
+  uint32_t delay,
+  int16_t autoTrigger_ms
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetTriggerChannelProperties)
+(
+  int16_t                     handle,
+  TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                     nChannelProperties,
+  int16_t                     auxOutputEnable,
+  int32_t                     autoTriggerMilliseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetExtTriggerRange)
+(
+  int16_t       handle,
+  PS4000_RANGE  extRange
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetTriggerChannelConditions)
+(
+  int16_t             handle,
+  TRIGGER_CONDITIONS *conditions,
+  int16_t             nConditions
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetTriggerChannelDirections)
+(
+  int16_t              handle,
+  THRESHOLD_DIRECTION  channelA,
+  THRESHOLD_DIRECTION  channelB,
+  THRESHOLD_DIRECTION  channelC,
+  THRESHOLD_DIRECTION  channelD,
+  THRESHOLD_DIRECTION  ext,
+  THRESHOLD_DIRECTION  aux
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetTriggerDelay)
+(
+  int16_t   handle,
+  uint32_t  delay
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetPulseWidthQualifier)
+(
+  int16_t              handle,
+  PWQ_CONDITIONS      *conditions,
+  int16_t              nConditions,
+  THRESHOLD_DIRECTION  direction,
+  uint32_t             lower,
+  uint32_t             upper,
+  PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000IsTriggerOrPulseWidthQualifierEnabled)
+(
+  int16_t  handle,
+  int16_t *triggerEnabled,
+  int16_t *pulseWidthQualifierEnabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTriggerTimeOffset)
+(
+  int16_t            handle,
+  uint32_t          *timeUpper,
+  uint32_t          *timeLower,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTriggerChannelTimeOffset)
+(
+  int16_t            handle,
+  uint32_t          *timeUpper,
+  uint32_t          *timeLower,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex,
+  PS4000_CHANNEL     channel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTriggerTimeOffset64)
+(
+  int16_t            handle,
+  int64_t           *time,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetTriggerChannelTimeOffset64)
+(
+  int16_t            handle,
+  int64_t           *time,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex,
+  PS4000_CHANNEL     channel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesTriggerTimeOffsetBulk)
+(
+  int16_t            handle,
+  uint32_t          *timesUpper,
+  uint32_t          *timesLower,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesTriggerChannelTimeOffsetBulk)
+(
+  int16_t            handle,
+  uint32_t          *timesUpper,
+  uint32_t          *timesLower,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex,
+  PS4000_CHANNEL     channel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesTriggerTimeOffsetBulk64)
+(
+  int16_t            handle,
+  int64_t           *times,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesTriggerChannelTimeOffsetBulk64)
+(
+  int16_t            handle,
+  int64_t           *times,
+  PS4000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex,
+  PS4000_CHANNEL     channel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetDataBufferBulk)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t        *buffer,
+  int32_t         bufferLth,
+  uint16_t        waveform
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetDataBuffers)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t        *bufferMax,
+  int16_t        *bufferMin,
+  int32_t         bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetDataBufferWithMode)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t        *buffer,
+  int32_t         bufferLth,
+  RATIO_MODE      mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetDataBuffersWithMode)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t        *bufferMax,
+  int16_t        *bufferMin,
+  int32_t         bufferLth,
+  RATIO_MODE      mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetDataBuffer)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t        *buffer,
+  int32_t         bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetEtsTimeBuffer)
+(
+  int16_t  handle,
+  int64_t *buffer,
+  int32_t  bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetEtsTimeBuffers)
+(
+  int16_t   handle,
+  uint32_t *timeUpper,
+  uint32_t *timeLower,
+  int32_t   bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000RunBlock)
+(
+  int16_t           handle,
+  int32_t           noOfPreTriggerSamples,
+  int32_t           noOfPostTriggerSamples,
+  uint32_t          timebase,
+  int16_t           oversample,
+  int32_t          *timeIndisposedMs,
+  uint16_t          segmentIndex,
+  ps4000BlockReady  lpReady,
+  void             *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000RunStreaming)
+(
+  int16_t            handle,
+  uint32_t          *sampleInterval,
+  PS4000_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t           maxPreTriggerSamples,
+  uint32_t           maxPostPreTriggerSamples,
+  int16_t            autoStop,
+  uint32_t           downSampleRatio,
+  uint32_t           overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000RunStreamingEx)
+(
+  int16_t            handle,
+  uint32_t          *sampleInterval,
+  PS4000_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t           maxPreTriggerSamples,
+  uint32_t           maxPostPreTriggerSamples,
+  int16_t            autoStop,
+  uint32_t           downSampleRatio,
+  int16_t            downSampleRatioMode,
+  uint32_t           overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000IsReady)
+(
+  int16_t handle,
+  int16_t * ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetStreamingLatestValues)
+(
+  int16_t               handle,
+  ps4000StreamingReady  lpPs4000Ready,
+  void                 *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000NoOfStreamingValues)
+(
+  int16_t   handle,
+  uint32_t *noOfValues
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetMaxDownSampleRatio)
+(
+  int16_t   handle,
+  uint32_t  noOfUnaggreatedSamples,
+  uint32_t *maxDownSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValues)
+(
+  int16_t   handle,
+  uint32_t  startIndex,
+  uint32_t *noOfSamples,
+  uint32_t  downSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex,
+  int16_t  *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesBulk)
+(
+  int16_t   handle,
+  uint32_t *noOfSamples,
+  uint16_t  fromSegmentIndex,
+  uint16_t  toSegmentIndex,
+  int16_t  *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetValuesAsync)
+(
+  int16_t   handle,
+  uint32_t  startIndex,
+  uint32_t  noOfSamples,
+  uint32_t  downSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex,
+  void     *lpDataReady,
+  void     *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000Stop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetProbe)
+(
+  int16_t       handle,
+  PS4000_PROBE  probe,
+  PS4000_RANGE  range
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000HoldOff)
+(
+  int16_t              handle,
+  uint64_t             holdoff,
+  PS4000_HOLDOFF_TYPE  type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetProbe)
+(
+  int16_t       handle,
+  PS4000_PROBE *probe
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetChannelInformation)
+(
+  int16_t              handle,
+  PS4000_CHANNEL_INFO  info,
+  int32_t              probe,
+  int32_t             *ranges,
+  int32_t             *length,
+  int32_t              channels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetFrequencyCounter)
+(
+  int16_t                         handle,
+  PS4000_CHANNEL                  channel,
+  int16_t                         enabled,
+  PS4000_FREQUENCY_COUNTER_RANGE  range,
+  int16_t                         thresholdMajor,
+  int16_t                         thresholdMinor
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000EnumerateUnits)
+(
+  int16_t *count,
+  int8_t  *serials,
+  int16_t *serialLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000PingUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000SetBwFilter)
+(
+  int16_t         handle,
+  PS4000_CHANNEL  channel,
+  int16_t         enable
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000TriggerWithinPreTriggerSamples)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000GetNoOfCaptures)
+(
+  int16_t   handle,
+  uint16_t *nCaptures
+);
+
+#endif

+ 1286 - 0
pico-tcp-service/pico-tcp/inc/ps4000aApi.h

@@ -0,0 +1,1286 @@
+/****************************************************************************
+ *
+ * Filename:    ps4000aApi.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *	PicoScope 4444 and 4824 PC Oscilloscopes.
+ *
+ * Copyright � 2013 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS4000AAPI_H__
+#define __PS4000AAPI_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+#include "PicoCallback.h"
+#include "PicoConnectProbes.h"
+#include "PicoVersion.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+	#define PREF0 extern "C"
+#else
+	#define PREF0
+#endif
+
+#ifdef WIN32
+/*	If you are dynamically linking ps4000a.dll into your project #define DYNLINK here
+ */
+#ifdef DYNLINK
+  #define PREF1 typedef
+	#define PREF2
+	#define PREF3(x) (__stdcall *x)
+#else
+  #define PREF1
+	#ifdef _USRDLL
+		#define PREF2 __declspec(dllexport) __stdcall
+	#else
+		#define PREF2 __declspec(dllimport) __stdcall
+	#endif
+  #define PREF3(x) x
+#endif
+	#define PREF4 __stdcall
+#else
+
+	/* Define a 64-bit integer type */
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+	#define PREF4
+#endif
+
+#define PS4000A_EXT_MAX_VALUE  32767
+#define PS4000A_EXT_MIN_VALUE -32767
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+#define MAX_DELAY_COUNT 8388607L
+
+#define PS4000A_MAX_SIG_GEN_BUFFER_SIZE 16384
+
+#define PS4000A_MIN_SIG_GEN_BUFFER_SIZE 10
+#define PS4000A_MIN_DWELL_COUNT				10
+#define PS4000A_MAX_SWEEPS_SHOTS				((1 << 30) - 1)
+#define	PS4000A_AWG_DAC_FREQUENCY							80e6
+#define	PS4000A_AWG_PHASE_ACCUMULATOR  4294967296.0
+
+#define PS4000A_MAX_ANALOGUE_OFFSET_50MV_200MV	 0.250f
+#define PS4000A_MIN_ANALOGUE_OFFSET_50MV_200MV	-0.250f
+#define PS4000A_MAX_ANALOGUE_OFFSET_500MV_2V		 2.500f
+#define PS4000A_MIN_ANALOGUE_OFFSET_500MV_2V		-2.500f
+#define PS4000A_MAX_ANALOGUE_OFFSET_5V_20V			 20.f
+#define PS4000A_MIN_ANALOGUE_OFFSET_5V_20V			-20.f
+#define PS4000A_MAX_ANALOGUE_OFFSET_10V_50V      25.f
+#define PS4000A_MIN_ANALOGUE_OFFSET_10V_50V     -25.f
+
+
+typedef enum enPS4000ADeviceResolution
+{
+	PS4000A_DR_8BIT,
+	PS4000A_DR_12BIT,
+	PS4000A_DR_14BIT,
+	PS4000A_DR_15BIT,
+	PS4000A_DR_16BIT,
+} PS4000A_DEVICE_RESOLUTION;
+
+typedef enum enPS4000AExtraOperations
+{
+	PS4000A_ES_OFF,
+	PS4000A_WHITENOISE,
+	PS4000A_PRBS // Pseudo-Random Bit Stream
+} PS4000A_EXTRA_OPERATIONS;
+
+typedef enum	enPS4000ABandwidthLimiterFlags
+{
+	PS4000A_BW_FULL_FLAG = (1 << 0),
+	PS4000A_BW_20KHZ_FLAG = (1 << 1),
+	PS4000A_BW_100KHZ_FLAG = (1 << 2), //( default when current clamp detected: can be changed)
+	PS4000A_BW_1MHZ_FLAG  = (1 << 3)  //( default for 14 bits: can be changed)
+} PS4000A_BANDWIDTH_LIMITER_FLAGS;
+
+typedef enum	enPS4000ABandwidthLimiter
+{
+	PS4000A_BW_FULL,
+	PS4000A_BW_20KHZ,
+	PS4000A_BW_100KHZ, //( default when current clamp detected: can be changed)
+	PS4000A_BW_1MHZ
+} PS4000A_BANDWIDTH_LIMITER;
+
+typedef enum enPS4000ACoupling
+{
+	PS4000A_AC,
+	PS4000A_DC
+} PS4000A_COUPLING;
+
+typedef enum enPS4000AChannel
+{
+	PS4000A_CHANNEL_A,
+	PS4000A_CHANNEL_B,
+	PS4000A_CHANNEL_C,
+	PS4000A_CHANNEL_D,
+	PS4000A_MAX_4_CHANNELS,
+	PS4000A_CHANNEL_E = PS4000A_MAX_4_CHANNELS,
+	PS4000A_CHANNEL_F,
+	PS4000A_CHANNEL_G,
+	PS4000A_CHANNEL_H,
+	PS4000A_EXTERNAL,
+	PS4000A_MAX_CHANNELS = PS4000A_EXTERNAL,
+	PS4000A_TRIGGER_AUX,
+	PS4000A_MAX_TRIGGER_SOURCES,
+	PS4000A_PULSE_WIDTH_SOURCE = 0x10000000
+}	PS4000A_CHANNEL;
+
+
+
+typedef enum enPS4000AChannelBufferIndex
+{
+	PS4000A_CHANNEL_A_MAX,
+	PS4000A_CHANNEL_A_MIN,
+	PS4000A_CHANNEL_B_MAX,
+	PS4000A_CHANNEL_B_MIN,
+	PS4000A_CHANNEL_C_MAX,
+	PS4000A_CHANNEL_C_MIN,
+	PS4000A_CHANNEL_D_MAX,
+	PS4000A_CHANNEL_D_MIN,
+	PS4000A_CHANNEL_E_MAX,
+	PS4000A_CHANNEL_E_MIN,
+	PS4000A_CHANNEL_F_MAX,
+	PS4000A_CHANNEL_F_MIN,
+	PS4000A_CHANNEL_G_MAX,
+	PS4000A_CHANNEL_G_MIN,
+	PS4000A_CHANNEL_H_MAX,
+	PS4000A_CHANNEL_H_MIN,
+	PS4000A_MAX_CHANNEL_BUFFERS
+} PS4000A_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS4000ARange
+{
+	PS4000A_10MV,
+	PS4000A_20MV,
+	PS4000A_50MV,
+	PS4000A_100MV,
+	PS4000A_200MV,
+	PS4000A_500MV,
+	PS4000A_1V,
+	PS4000A_2V,
+	PS4000A_5V,
+	PS4000A_10V,
+	PS4000A_20V,
+	PS4000A_50V,
+	PS4000A_100V,
+	PS4000A_200V,
+	PS4000A_MAX_RANGES
+}	PS4000A_RANGE;
+
+typedef enum enPS4000AResistanceRange
+{
+	PS4000A_RESISTANCE_315K = 0x00000200,
+	PS4000A_RESISTANCE_1100K,
+	PS4000A_RESISTANCE_10M,
+	PS4000A_MAX_RESISTANCE_RANGES = (PS4000A_RESISTANCE_10M + 1) - PS4000A_RESISTANCE_315K,
+	PS4000A_RESISTANCE_ADCV = 0x10000000
+}	PS4000A_RESISTANCE_RANGE;
+
+typedef enum enPS4000AEtsMode
+  {
+  PS4000A_ETS_OFF,             // ETS disabled
+  PS4000A_ETS_FAST,            // Return ready as soon as requested no of interleaves is available
+  PS4000A_ETS_SLOW,            // Return ready every time a new set of no_of_cycles is collected
+  PS4000A_ETS_MODES_MAX
+  }	PS4000A_ETS_MODE;
+
+typedef enum enPS4000ATimeUnits
+  {
+  PS4000A_FS,
+  PS4000A_PS,
+  PS4000A_NS,
+  PS4000A_US,
+  PS4000A_MS,
+  PS4000A_S,
+  PS4000A_MAX_TIME_UNITS,
+  }	PS4000A_TIME_UNITS;
+
+typedef enum enPS4000ASweepType
+{
+	PS4000A_UP,
+	PS4000A_DOWN,
+	PS4000A_UPDOWN,
+	PS4000A_DOWNUP,
+	PS4000A_MAX_SWEEP_TYPES
+} PS4000A_SWEEP_TYPE;
+
+typedef enum enPS4000AWaveType
+{
+	PS4000A_SINE,
+	PS4000A_SQUARE,
+	PS4000A_TRIANGLE,
+	PS4000A_RAMP_UP,
+	PS4000A_RAMP_DOWN,
+	PS4000A_SINC,
+	PS4000A_GAUSSIAN,
+	PS4000A_HALF_SINE,
+	PS4000A_DC_VOLTAGE,
+	PS4000A_WHITE_NOISE,
+	PS4000A_MAX_WAVE_TYPES
+} PS4000A_WAVE_TYPE;
+
+typedef enum enPS4000APinStates
+{
+	PS4000A_CAL_PINS_OFF,
+	PS4000A_GND_SIGNAL,
+	PS4000A_SIGNAL_SIGNAL
+} PS4000A_PIN_STATES;
+
+#define PS4000A_SINE_MAX_FREQUENCY				1000000.f
+#define PS4000A_SQUARE_MAX_FREQUENCY			1000000.f
+#define PS4000A_TRIANGLE_MAX_FREQUENCY		1000000.f
+#define PS4000A_SINC_MAX_FREQUENCY				1000000.f
+#define PS4000A_RAMP_MAX_FREQUENCY				1000000.f
+#define PS4000A_HALF_SINE_MAX_FREQUENCY	1000000.f
+#define PS4000A_GAUSSIAN_MAX_FREQUENCY		1000000.f
+#define PS4000A_MIN_FREQUENCY									 0.03f
+
+typedef enum enPS4000AChannelLed
+{
+	PS4000A_CHANNEL_LED_OFF,
+	PS4000A_CHANNEL_LED_RED,
+	PS4000A_CHANNEL_LED_GREEN
+} PS4000A_CHANNEL_LED;
+
+typedef enum enPS4000AProbeLedPosition
+{
+	PS4000A_UPPER_LEFT_LED = 1,
+	PS4000A_LOWER_LEFT_LED = 2,
+	PS4000A_UPPER_RIGHT_LED = 4,
+	PS4000A_LOWER_RIGHT_LED = 8,
+
+	PS4000A_RIGHT_LEDS = PS4000A_UPPER_RIGHT_LED | PS4000A_LOWER_RIGHT_LED,
+	PS4000A_LEFT_LEDS = PS4000A_UPPER_LEFT_LED | PS4000A_LOWER_LEFT_LED,
+
+	PS4000A_UPPER_LEDS = PS4000A_UPPER_RIGHT_LED | PS4000A_UPPER_LEFT_LED,
+	PS4000A_LOWER_LEDS = PS4000A_LOWER_RIGHT_LED | PS4000A_LOWER_LEFT_LED,
+
+	PS4000A_ALL_LEDS = PS4000A_UPPER_LEFT_LED | PS4000A_LOWER_LEFT_LED | PS4000A_UPPER_RIGHT_LED | PS4000A_LOWER_RIGHT_LED
+} PS4000A_PROBE_LED_POSITION;
+
+typedef enum enPS4000AMetaType
+{
+	PS4000A_MT_UNIT_INFO,
+	PS4000A_MT_DEVICE_CAPABILITY,
+	PS4000A_MT_DEVICE_SETTINGS,
+	PS4000A_MT_SIGNAL_GENERATOR_SETTINGS
+} PS4000A_META_TYPE;
+
+typedef enum enPS4000AMetaOperation
+{
+	PS4000A_MO_READ,
+	PS4000A_MO_WRITE
+} PS4000A_META_OPERATION;
+
+typedef enum enPS4000AMetaFormat
+{
+	PS4000A_MF_COMMA_SEPARATED,
+	PS4000A_MF_XML
+} PS4000A_META_FORMAT;
+
+typedef enum enPS4000ASigGenTrigType
+{
+	PS4000A_SIGGEN_RISING,
+	PS4000A_SIGGEN_FALLING,
+	PS4000A_SIGGEN_GATE_HIGH,
+	PS4000A_SIGGEN_GATE_LOW
+} PS4000A_SIGGEN_TRIG_TYPE;
+
+typedef enum enPS4000ASigGenTrigSource
+{
+	PS4000A_SIGGEN_NONE,
+	PS4000A_SIGGEN_SCOPE_TRIG,
+	PS4000A_SIGGEN_AUX_IN,
+	PS4000A_SIGGEN_EXT_IN,
+	PS4000A_SIGGEN_SOFT_TRIG
+} PS4000A_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPS4000AIndexMode
+{
+	PS4000A_SINGLE,
+	PS4000A_DUAL,
+	PS4000A_QUAD,
+	PS4000A_MAX_INDEX_MODES
+} PS4000A_INDEX_MODE;
+
+typedef enum enPS4000AThresholdMode
+{
+	PS4000A_LEVEL,
+	PS4000A_WINDOW
+} PS4000A_THRESHOLD_MODE;
+
+typedef enum enPS4000AThresholdDirection
+{
+	PS4000A_ABOVE, //using upper threshold
+	PS4000A_BELOW, //using upper threshold
+	PS4000A_RISING, // using upper threshold
+	PS4000A_FALLING, // using upper threshold
+	PS4000A_RISING_OR_FALLING, // using both threshold
+	PS4000A_ABOVE_LOWER, // using lower threshold
+	PS4000A_BELOW_LOWER, // using lower threshold
+	PS4000A_RISING_LOWER,			 // using lower threshold
+	PS4000A_FALLING_LOWER,		 // using lower threshold
+
+	// Windowing using both thresholds
+	PS4000A_INSIDE = PS4000A_ABOVE,
+	PS4000A_OUTSIDE = PS4000A_BELOW,
+	PS4000A_ENTER = PS4000A_RISING,
+	PS4000A_EXIT = PS4000A_FALLING,
+	PS4000A_ENTER_OR_EXIT = PS4000A_RISING_OR_FALLING,
+	PS4000A_POSITIVE_RUNT = 9,
+  PS4000A_NEGATIVE_RUNT,
+
+	// no trigger set
+  PS4000A_NONE = PS4000A_RISING
+} PS4000A_THRESHOLD_DIRECTION;
+
+
+typedef enum enPS4000ATriggerState
+{
+  PS4000A_CONDITION_DONT_CARE,
+  PS4000A_CONDITION_TRUE,
+  PS4000A_CONDITION_FALSE,
+	PS4000A_CONDITION_MAX
+} PS4000A_TRIGGER_STATE;
+
+typedef enum enPS4000ASensorState
+{
+	PS4000A_CONNECT_STATE_FLOATING,
+	PS4000A_SENSOR_STATE_CONNECTED
+} PS4000A_SENSOR_STATE;
+
+typedef enum enPS4000AFrequencyCounterRange
+{
+  PS4000A_FC_2K,
+  PS4000A_FC_20K,
+  PS4000A_FC_20,
+  PS4000A_FC_200,
+  PS4000A_FC_MAX
+}PS4000A_FREQUENCY_COUNTER_RANGE;
+
+typedef enum enPS4000AChannelFlags
+{
+	PS4000A_CHANNEL_A_FLAGS = 1,
+	PS4000A_CHANNEL_B_FLAGS = 2,
+	PS4000A_CHANNEL_C_FLAGS = 4,
+	PS4000A_CHANNEL_D_FLAGS = 8,
+	PS4000A_CHANNEL_E_FLAGS = 16,
+	PS4000A_CHANNEL_F_FLAGS = 32,
+	PS4000A_CHANNEL_G_FLAGS = 64,
+	PS4000A_CHANNEL_H_FLAGS = 128,
+}	PS4000A_CHANNEL_FLAGS;
+
+#pragma pack(push,1)
+typedef struct tPS4000AChannelLedSetting
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_CHANNEL_LED state;
+} PS4000A_CHANNEL_LED_SETTING;
+
+typedef struct ps4000aProbeLedColour
+{
+	uint8_t red;
+	uint8_t green;
+	uint8_t blue;
+} PS4000A_PROBE_LED_COLOUR;
+
+typedef struct tPS4000AProbeChannelLedSetting
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_PROBE_LED_POSITION position;
+	PS4000A_PROBE_LED_COLOUR rgb;
+} PS4000A_PROBE_CHANNEL_LED_SETTING;
+
+typedef struct tPS4000ADirection
+{
+	PS4000A_CHANNEL							channel;
+	PS4000A_THRESHOLD_DIRECTION direction;
+} PS4000A_DIRECTION;
+
+
+typedef struct tPS4000ACondition
+{
+	PS4000A_CHANNEL   		source;
+  PS4000A_TRIGGER_STATE condition;
+} PS4000A_CONDITION;
+
+typedef enum enPS4000AConditionsInfo
+{
+	PS4000A_CLEAR = 0x00000001,
+  PS4000A_ADD = 0x00000002
+} PS4000A_CONDITIONS_INFO;
+
+typedef struct tPS4000ATriggerChannelProperties
+{
+  int16_t										thresholdUpper;
+	uint16_t					thresholdUpperHysteresis;
+  int16_t										thresholdLower;
+	uint16_t					thresholdLowerHysteresis;
+	PS4000A_CHANNEL					channel;
+  PS4000A_THRESHOLD_MODE	thresholdMode;
+} PS4000A_TRIGGER_CHANNEL_PROPERTIES;
+
+typedef struct tPS4000AConnectDetect
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_SENSOR_STATE state;
+} PS4000A_CONNECT_DETECT;
+
+typedef struct tPS4000AUserProbeInteractions
+{
+	uint16_t connected;
+
+	PS4000A_CHANNEL channel;
+	uint16_t enabled;
+
+	PicoConnectProbe probeName;
+
+	uint8_t requiresPower_;
+	uint8_t isPowered_;
+
+	PICO_STATUS status_;
+
+	PICO_CONNECT_PROBE_RANGE probeOff;
+
+	PICO_CONNECT_PROBE_RANGE rangeFirst_;
+	PICO_CONNECT_PROBE_RANGE rangeLast_;
+	PICO_CONNECT_PROBE_RANGE rangeCurrent_;
+
+	PS4000A_COUPLING couplingFirst_;
+	PS4000A_COUPLING couplingLast_;
+	PS4000A_COUPLING couplingCurrent_;
+
+	PS4000A_BANDWIDTH_LIMITER_FLAGS filterFlags_;
+	PS4000A_BANDWIDTH_LIMITER_FLAGS filterCurrent_;
+
+	PS4000A_BANDWIDTH_LIMITER defaultFilter_;
+} PS4000A_USER_PROBE_INTERACTIONS;
+#pragma pack(pop)
+
+
+typedef enum enPS4000ARatioMode
+{
+	PS4000A_RATIO_MODE_NONE = 0,
+	PS4000A_RATIO_MODE_AGGREGATE = 1,
+	PS4000A_RATIO_MODE_DECIMATE = 2,
+	PS4000A_RATIO_MODE_AVERAGE = 4,
+	PS4000A_RATIO_MODE_DISTRIBUTION = 8
+} PS4000A_RATIO_MODE;
+
+typedef enum enPS4000APulseWidthType
+{
+	PS4000A_PW_TYPE_NONE,
+  PS4000A_PW_TYPE_LESS_THAN,
+	PS4000A_PW_TYPE_GREATER_THAN,
+	PS4000A_PW_TYPE_IN_RANGE,
+	PS4000A_PW_TYPE_OUT_OF_RANGE
+} PS4000A_PULSE_WIDTH_TYPE;
+
+typedef enum enPS4000AChannelInfo
+{
+	PS4000A_CI_RANGES,
+	PS4000A_CI_RESISTANCES,
+} PS4000A_CHANNEL_INFO;
+
+typedef void (PREF4 *ps4000aBlockReady)
+	(
+		int16_t											handle,
+		PICO_STATUS								status,
+		void										*	pParameter
+	);
+
+typedef void (PREF4 *ps4000aStreamingReady)
+	(
+		int16_t    									handle,
+		int32_t     									noOfSamples,
+		uint32_t							startIndex,
+		int16_t    									overflow,
+		uint32_t							triggerAt,
+		int16_t    									triggered,
+		int16_t    									autoStop,
+		void										*	pParameter
+	);
+
+
+typedef void (PREF4 *ps4000aDataReady)
+	(
+		int16_t    									handle,
+		PICO_STATUS								status,
+		uint32_t     				noOfSamples,
+		int16_t    									overflow,
+		void										*	pParameter
+	);
+
+
+typedef void (PREF4 *ps4000aProbeInteractions)
+	(
+		int16_t    												handle,
+		PICO_STATUS												status,
+		PS4000A_USER_PROBE_INTERACTIONS * probes,
+		uint32_t													nProbes
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aOpenUnitWithResolution)
+(
+	int16_t											* handle,
+	int8_t											* serial,
+	PS4000A_DEVICE_RESOLUTION			resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnit)
+  (
+	  int16_t											* handle,
+		int8_t											* serial
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aOpenUnitAsyncWithResolution)
+(
+	int16_t											* status,
+	int8_t											* serial,
+	PS4000A_DEVICE_RESOLUTION			resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnitAsync)
+  (
+	  int16_t											* status,
+		int8_t											* serial
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnitProgress)
+	(
+	  int16_t 										* handle,
+	  int16_t 										* progressPercent,
+	  int16_t 										* complete
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetUnitInfo)
+ 	(
+	  int16_t     								  handle,
+	  int8_t      								* string,
+	  int16_t     								  stringLength,
+	  int16_t     								* requiredSize,
+	  PICO_INFO 								  info
+	);
+
+// This function retrieves information about the accessory (e.g. probe) attached to the specified channel.
+// Note: you must set a probe interaction callback to be able to retrieve probe information.
+//
+// parameters:
+// handle: identifies the device to which the accessory is attached.
+// channel: identifies the channel to which the accessory is attached. If no accessory is connected to this channel, an error will result.
+// string: on exit, the accessory information string selected specified by the info argument. If string is NULL, only requiredSize is returned.
+// stringLength: the maximum number of 8-bit integers (int8_t) that may be written to string.
+// requiredSize: on exit, the required length of the string array.
+// info: a number specifying what information is required. Note that unlike ps6000aGetUnitInfo, only PICO_BATCH_AND_SERIAL and PICO_CAL_DATE are valid for accessories.
+//
+// return:
+// PICO_OK
+// PICO_INVALID_HANDLE (handle isn't that of an open PicoScope device.)
+// PICO_PROBE_COLLECTION_NOT_STARTED (handle hasn't got a probe interaction callback set).
+// PICO_INVALID_CHANNEL (channel doesn't map to a channel on the device with handle.)
+// PICO_NULL_PARAMETER (requiredSize is NULL.)
+// PICO_INVALID_INFO (info is an invalid value for the attached accessory.)
+// PICO_INFO_UNAVAILABLE (no accessory is connected, or the connected accessory does not support any info.)
+// PICO_DRIVER_FUNCTION (another thread is already calling a driver function.)
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetAccessoryInfo)
+  (
+	  int16_t     								  handle,
+	  PS4000A_CHANNEL							  channel,
+	  int8_t											* string,
+	  int16_t     								  stringLength,
+	  int16_t											* requiredSize,
+	  PICO_INFO 								  info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aFlashLed)
+	(
+	  int16_t 											handle,
+		int16_t 											start
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetChannelLed)
+	(
+	int16_t 												handle,
+	PS4000A_CHANNEL_LED_SETTING		*	ledStates,
+	uint16_t												nLedStates
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsLedFlashing)
+	(
+	  int16_t 										  handle,
+		int16_t 										* status
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aCloseUnit)
+	(
+	  int16_t												handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMemorySegments)
+	(
+	  int16_t												handle,
+		uint32_t								nSegments,
+		int32_t											* nMaxSamples
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetChannel)
+ 	(
+	  int16_t											handle,
+		PS4000A_CHANNEL						channel,
+	  int16_t											enabled,
+	  PS4000A_COUPLING					type,
+		PICO_CONNECT_PROBE_RANGE				range,
+		float											analogOffset
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetBandwidthFilter)
+ 	(
+	  int16_t												handle,
+	  PS4000A_CHANNEL							channel,
+	  PS4000A_BANDWIDTH_LIMITER		bandwidth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aApplyResistanceScaling)
+	(
+	int16_t											handle,
+	PS4000A_CHANNEL							channel,
+	PICO_CONNECT_PROBE_RANGE					range,
+	int16_t										* bufferMax,
+	int16_t										* bufferMin,
+	uint32_t										buffertLth,
+	int16_t										* overflow
+	);
+
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTimebase)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   int32_t											* timeIntervalNanoseconds,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTimebase2)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   float										* timeIntervalNanoseconds,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSigGenArbitrary)
+	(
+	 	int16_t												handle,
+	 	int32_t												offsetVoltage,
+	 	uint32_t								pkToPk,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+	 	int16_t											*	arbitraryWaveform,
+	 	int32_t												arbitraryWaveformSize,
+		PS4000A_SWEEP_TYPE					sweepType,
+		PS4000A_EXTRA_OPERATIONS		operation,
+		PS4000A_INDEX_MODE					indexMode,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetSigGenBuiltIn)
+	(
+		int16_t												handle,
+		int32_t												offsetVoltage,
+		uint32_t								pkToPk,
+		PS4000A_WAVE_TYPE						waveType,
+		double											startFrequency,
+		double											stopFrequency,
+		double											increment,
+		double											dwellTime,
+		PS4000A_SWEEP_TYPE					sweepType,
+		PS4000A_EXTRA_OPERATIONS		operation,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+		);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSigGenPropertiesArbitrary)
+	(
+	 	int16_t												handle,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+		PS4000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetSigGenPropertiesBuiltIn)
+	(
+		int16_t												handle,
+		double											startFrequency,
+		double											stopFrequency,
+		double											increment,
+		double											dwellTime,
+		PS4000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSigGenFrequencyToPhase)
+	(
+		int16_t												handle,
+		double												frequency,
+		PS4000A_INDEX_MODE						indexMode,
+		uint32_t											bufferLength,
+		uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSigGenSoftwareControl)
+	(
+		int16_t												handle,
+		int16_t												state
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEts)
+  (
+		int16_t												handle,
+		PS4000A_ETS_MODE						mode,
+		int16_t												etsCycles,
+		int16_t												etsInterleave,
+		int32_t											* sampleTimePicoseconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelProperties)
+	(
+		int16_t																				handle,
+		PS4000A_TRIGGER_CHANNEL_PROPERTIES			 *	channelProperties,
+		int16_t																				nChannelProperties,
+		int16_t																				auxOutputEnable,
+		int32_t																				autoTriggerMilliseconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelConditions)
+	(
+		int16_t													handle,
+		PS4000A_CONDITION					*		conditions,
+		int16_t													nConditions,
+		PS4000A_CONDITIONS_INFO				info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelDirections)
+	(
+		int16_t													handle,
+		PS4000A_DIRECTION					*		directions,
+		int16_t													nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSimpleTrigger)
+	(
+		int16_t												handle,
+		int16_t												enable,
+		PS4000A_CHANNEL							source,
+		int16_t												threshold,
+		PS4000A_THRESHOLD_DIRECTION direction,
+		uint32_t								delay,
+		int16_t												autoTrigger_ms
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerDelay)
+	(
+		int16_t									handle,
+		uint32_t					delay
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetPulseWidthQualifierProperties)
+	(
+		int16_t														handle,
+		PS4000A_THRESHOLD_DIRECTION			direction,
+		uint32_t										lower,
+		uint32_t										upper,
+		PS4000A_PULSE_WIDTH_TYPE				type
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetPulseWidthQualifierConditions)
+	(
+		int16_t												handle,
+		PS4000A_CONDITION					*	conditions,
+		int16_t												nConditions,
+		PS4000A_CONDITIONS_INFO			info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsTriggerOrPulseWidthQualifierEnabled)
+	(
+		int16_t 								handle,
+		int16_t 							* triggerEnabled,
+		int16_t 							* pulseWidthQualifierEnabled
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTriggerTimeOffset)
+	(
+		int16_t									handle,
+		uint32_t 			* timeUpper,
+		uint32_t 			* timeLower,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					segmentIndex
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTriggerTimeOffset64)
+	(
+		int16_t									handle,
+		int64_t							* time,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t				segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesTriggerTimeOffsetBulk)
+	(
+	  int16_t									handle,
+		uint32_t				*	timesUpper,
+		uint32_t				* timesLower,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					fromSegmentIndex,
+		uint32_t					toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesTriggerTimeOffsetBulk64)
+	(
+	  int16_t									handle,
+		int64_t							*	times,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					fromSegmentIndex,
+		uint32_t					toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetDataBuffers)
+(
+   int16_t									handle,
+	 PS4000A_CHANNEL 				channel,
+	 int16_t								*	bufferMax,
+	 int16_t								*	bufferMin,
+   int32_t										bufferLth,
+	 uint32_t					segmentIndex,
+	 PS4000A_RATIO_MODE			mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetDataBuffer)
+(
+   int16_t								 handle,
+	 PS4000A_CHANNEL 			 channel,
+	 int16_t							*  buffer,
+   int32_t									 bufferLth,
+	 uint32_t				 segmentIndex,
+	 PS4000A_RATIO_MODE		 mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEtsTimeBuffer)
+(
+   int16_t									handle,
+	 int64_t *							buffer,
+	 int32_t										bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEtsTimeBuffers)
+(
+   int16_t									handle,
+	 uint32_t				* timeUpper,
+	 uint32_t				* timeLower,
+	 int32_t										bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsReady)
+	(
+		int16_t handle,
+		int16_t * ready
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aRunBlock)
+	(
+		int16_t									handle,
+		int32_t									noOfPreTriggerSamples,
+		int32_t									noOfPostTriggerSamples,
+		uint32_t					timebase,
+		int32_t								* timeIndisposedMs,
+		uint32_t					segmentIndex,
+		ps4000aBlockReady			lpReady,
+		void								* pParameter
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aRunStreaming)
+  (
+	  int16_t									handle,
+		uint32_t				* sampleInterval,
+		PS4000A_TIME_UNITS		sampleIntervalTimeUnits,
+	  uint32_t					maxPreTriggerSamples,
+	  uint32_t					maxPostTriggerSamples,
+		int16_t									autoStop,
+		uint32_t					downSampleRatio,
+		PS4000A_RATIO_MODE		downSampleRatioMode,
+    uint32_t					overviewBufferSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetStreamingLatestValues)
+  (
+    int16_t									handle,
+    ps4000aStreamingReady	lpPs4000aReady,
+		void								* pParameter
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aNoOfStreamingValues)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfValues
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetMaxDownSampleRatio)
+	(
+	  int16_t								handle,
+		uint32_t 			noOfUnaggregatedSamples,
+		uint32_t 		* maxDownSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValues)
+	(
+	  int16_t								handle,
+		uint32_t 			startIndex,
+	  uint32_t			*	noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex,
+		int16_t							* overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesAsync)
+	(
+	  int16_t								handle,
+		uint32_t				startIndex,
+	  uint32_t				noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex,
+	  void							*	lpDataReady,
+		void							*	pParameter
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesBulk)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfSamples,
+		uint32_t				fromSegmentIndex,
+		uint32_t				toSegmentIndex,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE 	downSampleRatioMode,
+		int16_t							* overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesOverlapped)
+	(
+	  int16_t										handle,
+	  uint32_t			 			startIndex,
+	  uint32_t					*	noOfSamples,
+	  uint32_t						downSampleRatio,
+	  PS4000A_RATIO_MODE			downSampleRatioMode,
+		uint32_t						segmentIndex,
+	  int16_t									* overflow
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesOverlappedBulk)
+	(
+	  int16_t									handle,
+		uint32_t					startIndex,
+  	uint32_t 	 		*	noOfSamples,
+	  uint32_t					downSampleRatio,
+	  PS4000A_RATIO_MODE		downSampleRatioMode,
+	  uint32_t					fromSegmentIndex,
+	  uint32_t					toSegmentIndex,
+	  int16_t								*	overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aEnumerateUnits)
+	(
+	int16_t * count,
+	int8_t * serials,
+	int16_t * serialLth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetChannelInformation)
+	(
+	int16_t										handle,
+	PS4000A_CHANNEL_INFO		info,
+	int32_t											probe,
+	int32_t										* ranges,
+	int32_t										* length,
+	int32_t											channels);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aConnectDetect)
+	(
+	int16_t		handle,
+	PS4000A_CONNECT_DETECT * sensor,
+	int16_t  nSensors
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeInteractionCallback)
+ (
+	int16_t		handle,
+	ps4000aProbeInteractions callback
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aCalibrateProbe)
+(
+	int16_t	handle,
+	PS4000A_CHANNEL channel,
+	int16_t * checkCalibrationRequired
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeLedColour)
+(
+	int16_t		handle,
+	PS4000A_PROBE_CHANNEL_LED_SETTING * settings,
+	uint16_t nSettings
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aRegisterProbeLedColour)
+(
+	int16_t		handle,
+	PICO_CONNECT_PROBE probe,
+	PS4000A_PROBE_CHANNEL_LED_SETTING * settings,
+	uint16_t nSettings
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeLedDefaults)
+  (
+    int16_t handle,
+    int16_t enabled
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMaximumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMinimumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetAnalogueOffset)
+	(
+	int16_t							handle,
+	PICO_CONNECT_PROBE_RANGE	range,
+	PS4000A_COUPLING		coupling,
+	float							* maximumOffset,
+	float							* minimumOffset
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetMaxSegments)
+	(
+	int16_t						handle,
+	uint32_t * maxSegments
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aChangePowerSource)
+	(
+	int16_t				handle,
+  PICO_STATUS powerState
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aCurrentPowerSource)
+	(
+	int16_t		handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aStop)
+	(
+	  int16_t handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aPingUnit)
+	(
+	  int16_t handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetNoOfCaptures)
+	(
+	int16_t					handle,
+	uint32_t nCaptures
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetNoOfCaptures)
+  (
+    int16_t                handle,
+    uint32_t               * nCaptures
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetNoOfProcessedCaptures)
+  (
+    int16_t                handle,
+    uint32_t               * nProcessedCaptures
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aDeviceMetaData)
+	(
+	int16_t										handle,
+	int8_t									*	settings,
+	int32_t									*	nSettingsLength,
+	PS4000A_META_TYPE					type,
+	PS4000A_META_OPERATION		operation,
+	PS4000A_META_FORMAT				format
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetString)
+	(
+	int16_t										handle,
+	PICO_STRING_VALUE					stringValue,
+	int8_t									*	string,
+	int32_t									*	stringLength
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetCommonModeOverflow)
+	(
+	int16_t			handle,
+	uint16_t	*	overflow
+	);
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetFrequencyCounter)
+(
+    int16_t                                handle,
+    PS4000A_CHANNEL                        channel,
+    int16_t                                enabled,
+    PS4000A_FREQUENCY_COUNTER_RANGE        range,
+    int16_t                                thresholdMajor,
+    int16_t                                thresholdMinor
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetDeviceResolution)
+(
+  int16_t                          handle,
+  PS4000A_DEVICE_RESOLUTION        resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetDeviceResolution)
+(
+	int16_t                      handle,
+	PS4000A_DEVICE_RESOLUTION    * resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetCalibrationPins)
+(
+	int16_t               handle,
+	PS4000A_PIN_STATES		pinStates,
+	PS4000A_WAVE_TYPE			waveType,
+	double								frequency,
+	uint32_t							amplitude,
+	uint32_t							offset
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aNearestSampleIntervalStateless)
+(
+	int16_t                        handle,
+	PS4000A_CHANNEL_FLAGS          enabledChannelOrPortFlags,
+	double                         timeIntervalRequested,
+	PS4000A_DEVICE_RESOLUTION      resolution,
+	uint16_t                       useEts,
+	uint32_t                       * timebase,
+	double                         * timeIntervalAvailable
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetMinimumTimebaseStateless)
+(
+	int16_t                        handle,
+	PS4000A_CHANNEL_FLAGS          enabledChannelOrPortFlags,
+	uint32_t                       * timebase,
+	double                         * timeInterval,
+	PS4000A_DEVICE_RESOLUTION      resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aCheckForUpdate)
+(
+	int16_t handle,
+	PICO_FIRMWARE_INFO* firmwareInfos,
+    int16_t* nFirmwareInfos,
+    uint16_t* updatesRequired
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aStartFirmwareUpdate)
+(
+	int16_t handle,
+	PicoUpdateFirmwareProgress progress
+	);
+
+#endif

+ 749 - 0
pico-tcp-service/pico-tcp/inc/ps5000Api.h

@@ -0,0 +1,749 @@
+/****************************************************************************
+ *
+ * Filename:    ps5000Api.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 5203 and 5204 PC Oscilloscopes.
+ *
+ * Copyright � 2002 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS5000API_H__
+#define __PS5000API_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+/*  If you are dynamically linking ps5000.dll into your project #define DYNLINK here
+ */
+#ifdef DYNLINK
+  #define PREF1 typedef
+  #define PREF2
+  #define PREF3(x) (__stdcall *x)
+#else
+  #define PREF1
+  #ifdef _USRDLL
+    #define PREF2 __declspec(dllexport) __stdcall
+  #else
+    #define PREF2 __declspec(dllimport) __stdcall
+  #endif
+  #define PREF3(x) x
+#endif
+  #define PREF4 __stdcall
+#else
+
+  /* Define a 64-bit integer type */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+#define PS5000_MAX_OVERSAMPLE_8BIT 256
+
+/* Although the PS5000 uses an 8-bit ADC, it is usually possible to
+ * oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+#define PS5000_MAX_VALUE  32512
+#define PS5000_MIN_VALUE -32512
+#define PS5000_LOST_DATA -32768
+
+#define PS5000_EXT_MAX_VALUE  32767
+#define PS5000_EXT_MIN_VALUE -32767
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+#define MAX_DELAY_COUNT 8388607L
+
+#define MAX_SIG_GEN_BUFFER_SIZE 8192
+#define MIN_SIG_GEN_BUFFER_SIZE 10
+#define MIN_DWELL_COUNT         10
+#define MAX_SWEEPS_SHOTS ((1 << 30) - 1)
+
+typedef enum enPS5000Channel
+{
+  PS5000_CHANNEL_A,
+  PS5000_CHANNEL_B,
+  PS5000_CHANNEL_C,
+  PS5000_CHANNEL_D,
+  PS5000_EXTERNAL,
+  PS5000_MAX_CHANNELS = PS5000_EXTERNAL,
+  PS5000_TRIGGER_AUX,
+  PS5000_MAX_TRIGGER_SOURCES
+}  PS5000_CHANNEL;
+
+typedef enum enChannelBufferIndex
+{
+  PS5000_CHANNEL_A_MAX,
+  PS5000_CHANNEL_A_MIN,
+  PS5000_CHANNEL_B_MAX,
+  PS5000_CHANNEL_B_MIN,
+  PS5000_CHANNEL_C_MAX,
+  PS5000_CHANNEL_C_MIN,
+  PS5000_CHANNEL_D_MAX,
+  PS5000_CHANNEL_D_MIN,
+  PS5000_MAX_CHANNEL_BUFFERS
+} PS5000_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS5000Range
+{
+  PS5000_10MV,
+  PS5000_20MV,
+  PS5000_50MV,
+  PS5000_100MV,
+  PS5000_200MV,
+  PS5000_500MV,
+  PS5000_1V,
+  PS5000_2V,
+  PS5000_5V,
+  PS5000_10V,
+  PS5000_20V,
+  PS5000_50V,
+  PS5000_MAX_RANGES
+}  PS5000_RANGE;
+
+
+typedef enum enPS5000EtsMode
+  {
+  PS5000_ETS_OFF,      // ETS disabled
+  PS5000_ETS_FAST,     // Return ready as soon as requested no of interleaves is available
+  PS5000_ETS_SLOW,     // Return ready every time a new set of no_of_cycles is collected
+  PS5000_ETS_MODES_MAX
+  }  PS5000_ETS_MODE;
+
+typedef enum enPS5000TimeUnits
+  {
+  PS5000_FS,
+  PS5000_PS,
+  PS5000_NS,
+  PS5000_US,
+  PS5000_MS,
+  PS5000_S,
+  PS5000_MAX_TIME_UNITS,
+  }  PS5000_TIME_UNITS;
+
+typedef enum enSweepType
+{
+  UP,
+  DOWN,
+  UPDOWN,
+  DOWNUP,
+  MAX_SWEEP_TYPES
+} SWEEP_TYPE;
+
+typedef enum enWaveType
+{
+  PS5000_SINE,
+  PS5000_SQUARE,
+  PS5000_TRIANGLE,
+  PS5000_RAMP_UP,
+  PS5000_RAMP_DOWN,
+  PS5000_SINC,
+  PS5000_GAUSSIAN,
+  PS5000_HALF_SINE,
+  PS5000_DC_VOLTAGE,
+  PS5000_WHITE_NOISE,
+  MAX_WAVE_TYPES
+} WAVE_TYPE;
+
+#define PS5000_SINE_MAX_FREQUENCY        20000000.f
+#define PS5000_SQUARE_MAX_FREQUENCY      20000000.f
+#define PS5000_TRIANGLE_MAX_FREQUENCY    20000000.f
+#define PS5000_SINC_MAX_FREQUENCY        20000000.f
+#define PS5000_RAMP_MAX_FREQUENCY        20000000.f
+#define PS5000_HALF_SINE_MAX_FREQUENCY   20000000.f
+#define PS5000_GAUSSIAN_MAX_FREQUENCY    20000000.f
+#define PS5000_MIN_FREQUENCY                  0.03f
+
+typedef enum enSigGenTrigType
+{
+  SIGGEN_RISING,
+  SIGGEN_FALLING,
+  SIGGEN_GATE_HIGH,
+  SIGGEN_GATE_LOW
+} SIGGEN_TRIG_TYPE;
+
+typedef enum enSigGenTrigSource
+{
+  SIGGEN_NONE,
+  SIGGEN_SCOPE_TRIG,
+  SIGGEN_AUX_IN,
+  SIGGEN_EXT_IN,
+  SIGGEN_SOFT_TRIG
+} SIGGEN_TRIG_SOURCE;
+
+typedef enum enIndexMode
+{
+  SINGLE,
+  DUAL,
+  QUAD,
+  MAX_INDEX_MODES
+} INDEX_MODE;
+
+typedef enum enThresholdMode
+{
+  LEVEL,
+  WINDOW
+} THRESHOLD_MODE;
+
+typedef enum enThresholdDirection
+{
+  ABOVE,
+  BELOW,
+  RISING,
+  FALLING,
+  RISING_OR_FALLING,
+  INSIDE = ABOVE,
+  OUTSIDE = BELOW,
+  ENTER = RISING,
+  EXIT = FALLING,
+  ENTER_OR_EXIT = RISING_OR_FALLING,
+  NONE = RISING
+} THRESHOLD_DIRECTION;
+
+typedef enum enTriggerState
+{
+  CONDITION_DONT_CARE,
+  CONDITION_TRUE,
+  CONDITION_FALSE,
+  CONDITION_MAX
+} TRIGGER_STATE;
+
+#pragma pack(push,1)
+typedef struct tTriggerConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+  TRIGGER_STATE aux;
+  TRIGGER_STATE pulseWidthQualifier;
+} TRIGGER_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPwqConditions
+{
+  TRIGGER_STATE channelA;
+  TRIGGER_STATE channelB;
+  TRIGGER_STATE channelC;
+  TRIGGER_STATE channelD;
+  TRIGGER_STATE external;
+  TRIGGER_STATE aux;
+} PWQ_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tTriggerChannelProperties
+{
+  int16_t thresholdMajor;
+  int16_t thresholdMinor;
+  uint16_t hysteresis;
+  PS5000_CHANNEL channel;
+  THRESHOLD_MODE thresholdMode;
+} TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack(pop)
+
+typedef enum enRatioMode
+{
+  RATIO_MODE_NONE = 0,
+  RATIO_MODE_AGGREGATE = 1,
+  RATIO_MODE_DECIMATE = 2,
+  RATIO_MODE_AVERAGE = 4,
+  RATIO_MODE_DISTRIBUTION = 8
+} RATIO_MODE;
+
+typedef enum enPulseWidthType
+{
+  PW_TYPE_NONE,
+  PW_TYPE_LESS_THAN,
+  PW_TYPE_GREATER_THAN,
+  PW_TYPE_IN_RANGE,
+  PW_TYPE_OUT_OF_RANGE
+} PULSE_WIDTH_TYPE;
+
+typedef enum enPS5000ChannelInfo
+{
+  CI_RANGES,
+} PS5000_CHANNEL_INFO;
+
+typedef void (PREF4 *ps5000BlockReady)
+(
+  int16_t      handle,
+  PICO_STATUS  status,
+  void        *pParameter
+);
+
+typedef void (PREF4 *ps5000StreamingReady)
+(
+  int16_t   handle,
+  int32_t   noOfSamples,
+  uint32_t  startIndex,
+  int16_t   overflow,
+  uint32_t  triggerAt,
+  int16_t   triggered,
+  int16_t   autoStop,
+  void     *pParameter
+);
+
+typedef void (PREF4 *ps5000DataReady)
+(
+  int16_t   handle,
+  int32_t   noOfSamples,
+  int16_t   overflow,
+  uint32_t  triggerAt,
+  int16_t   triggered,
+  void     *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000OpenUnit)
+(
+  int16_t *handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000OpenUnitAsync)
+(
+  int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000OpenUnitProgress)
+(
+  int16_t *handle,
+  int16_t *progressPercent,
+  int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetUnitInfo)
+(
+  int16_t    handle,
+  int8_t    *string,
+  int16_t    stringLength,
+  int16_t   *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000FlashLed)
+(
+  int16_t  handle,
+  int16_t  start
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000IsLedFlashing)
+(
+  int16_t  handle,
+  int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000CloseUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000MemorySegments)
+(
+  int16_t   handle,
+  uint16_t  nSegments,
+  int32_t  *nMaxSamples
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetChannel)
+(
+  int16_t         handle,
+  PS5000_CHANNEL  channel,
+  int16_t         enabled,
+  int16_t         dc,
+  PS5000_RANGE    range
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetTimebase)
+(
+  int16_t   handle,
+  uint32_t  timebase,
+  int32_t   noSamples,
+  int32_t  *timeIntervalNanoseconds,
+  int16_t   oversample,
+  int32_t  *maxSamples,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetTimebase2)
+(
+  int16_t   handle,
+  uint32_t  timebase,
+  int32_t   noSamples,
+  float    *timeIntervalNanoseconds,
+  int16_t   oversample,
+  int32_t  *maxSamples,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetSigGenArbitrary)
+(
+  int16_t             handle,
+  int32_t             offsetVoltage,
+  uint32_t            pkToPk,
+  uint32_t            startDeltaPhase,
+  uint32_t            stopDeltaPhase,
+  uint32_t            deltaPhaseIncrement,
+  uint32_t            dwellCount,
+  int16_t            *arbitraryWaveform,
+  int32_t             arbitraryWaveformSize,
+  SWEEP_TYPE          sweepType,
+  int16_t             whiteNoise,
+  INDEX_MODE          indexMode,
+  uint32_t            shots,
+  uint32_t            sweeps,
+  SIGGEN_TRIG_TYPE    triggerType,
+  SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t             extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000SetSigGenBuiltIn)
+(
+  int16_t             handle,
+  int32_t             offsetVoltage,
+  uint32_t            pkToPk,
+  int16_t             waveType,
+  float               startFrequency,
+  float               stopFrequency,
+  float               increment,
+  float               dwellTime,
+  SWEEP_TYPE          sweepType,
+  int16_t             whiteNoise,
+  uint32_t            shots,
+  uint32_t            sweeps,
+  SIGGEN_TRIG_TYPE    triggerType,
+  SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t             extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000SetSigGenBuiltInV2)
+(
+  int16_t             handle,
+  int32_t             offsetVoltage,
+  uint32_t            pkToPk,
+  int16_t             waveType,
+  double              startFrequency,
+  double              stopFrequency,
+  double              increment,
+  double              dwellTime,
+  SWEEP_TYPE          sweepType,
+  int16_t             whiteNoise,
+  uint32_t            shots,
+  uint32_t            sweeps,
+  SIGGEN_TRIG_TYPE    triggerType,
+  SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t             extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000SigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	INDEX_MODE										indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000SigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SigGenSoftwareControl)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetEts)
+(
+  int16_t          handle,
+  PS5000_ETS_MODE  mode,
+  int16_t          etsCycles,
+  int16_t          etsInterleave,
+  int32_t         *sampleTimePicoseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetTriggerChannelProperties)
+(
+  int16_t                     handle,
+  TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                     nChannelProperties,
+  int16_t                     auxOutputEnable,
+  int32_t                     autoTriggerMilliseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetTriggerChannelConditions)
+(
+  int16_t             handle,
+  TRIGGER_CONDITIONS *conditions,
+  int16_t             nConditions
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetTriggerChannelDirections)
+(
+  int16_t              handle,
+  THRESHOLD_DIRECTION  channelA,
+  THRESHOLD_DIRECTION  channelB,
+  THRESHOLD_DIRECTION  channelC,
+  THRESHOLD_DIRECTION  channelD,
+  THRESHOLD_DIRECTION  ext,
+  THRESHOLD_DIRECTION  aux
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetSimpleTrigger)
+(
+  int16_t              handle,
+  int16_t              enable,
+  PS5000_CHANNEL       source,
+  int16_t              threshold,
+  THRESHOLD_DIRECTION  direction,
+  uint32_t             delay,
+  int16_t              autoTrigger_ms
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetTriggerDelay)
+(
+  int16_t   handle,
+  uint32_t  delay
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetPulseWidthQualifier)
+(
+  int16_t              handle,
+  PWQ_CONDITIONS      *conditions,
+  int16_t              nConditions,
+  THRESHOLD_DIRECTION  direction,
+  uint32_t             lower,
+  uint32_t             upper,
+  PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000IsTriggerOrPulseWidthQualifierEnabled)
+(
+  int16_t  handle,
+  int16_t *triggerEnabled,
+  int16_t *pulseWidthQualifierEnabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetTriggerTimeOffset)
+(
+  int16_t            handle,
+  uint32_t          *timeUpper,
+  uint32_t          *timeLower,
+  PS5000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetTriggerTimeOffset64)
+(
+  int16_t            handle,
+  int64_t           *time,
+  PS5000_TIME_UNITS *timeUnits,
+  uint16_t           segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetValuesTriggerTimeOffsetBulk)
+(
+  int16_t            handle,
+  uint32_t          *timesUpper,
+  uint32_t          *timesLower,
+  PS5000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetValuesTriggerTimeOffsetBulk64)
+(
+  int16_t            handle,
+  int64_t           *times,
+  PS5000_TIME_UNITS *timeUnits,
+  uint16_t           fromSegmentIndex,
+  uint16_t           toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetDataBuffers)
+(
+  int16_t         handle,
+  PS5000_CHANNEL  channel,
+  int16_t        *bufferMax,
+  int16_t        *bufferMin,
+  int32_t         bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetDataBuffer)
+(
+   int16_t         handle,
+   PS5000_CHANNEL  channel,
+   int16_t        *buffer,
+   int32_t         bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetDataBufferBulk)
+(
+  int16_t         handle,
+  PS5000_CHANNEL  channel,
+  int16_t        *buffer,
+  int32_t         bufferLth,
+  uint16_t        waveform
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetEtsTimeBuffer)
+(
+  int16_t  handle,
+  int64_t *buffer,
+  int32_t  bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetEtsTimeBuffers)
+(
+  int16_t   handle,
+  uint32_t *timeUpper,
+  uint32_t *timeLower,
+  int32_t   bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000IsReady)
+(
+  int16_t  handle,
+  int16_t *ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000RunBlock)
+(
+  int16_t           handle,
+  int32_t           noOfPreTriggerSamples,
+  int32_t           noOfPostTriggerSamples,
+  uint32_t          timebase,
+  int16_t           oversample,
+  int32_t          *timeIndisposedMs,
+  uint16_t          segmentIndex,
+  ps5000BlockReady  lpReady,
+  void             *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000RunStreaming)
+(
+  int16_t            handle,
+  uint32_t          *sampleInterval,
+  PS5000_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t           maxPreTriggerSamples,
+  uint32_t           maxPostPreTriggerSamples,
+  int16_t            autoStop,
+  uint32_t           downSampleRatio,
+  uint32_t           overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetStreamingLatestValues)
+(
+  int16_t               handle,
+  ps5000StreamingReady  lpPs5000Ready,
+  void                 *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000NoOfStreamingValues)
+(
+  int16_t   handle,
+  uint32_t *noOfValues
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetMaxDownSampleRatio)
+(
+  int16_t   handle,
+  uint32_t  noOfUnaggreatedSamples,
+  uint32_t *maxDownSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetValues)
+(
+  int16_t   handle,
+  uint32_t  startIndex,
+  uint32_t *noOfSamples,
+  uint32_t  downSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex,
+  int16_t  *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetValuesBulk)
+(
+  int16_t   handle,
+  uint32_t *noOfSamples,
+  uint16_t  fromSegmentIndex,
+  uint16_t  toSegmentIndex,
+  int16_t  *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000GetValuesAsync)
+(
+  int16_t   handle,
+  uint32_t  startIndex,
+  uint32_t  noOfSamples,
+  uint32_t  downSampleRatio,
+  int16_t   downSampleRatioMode,
+  uint16_t  segmentIndex,
+  void     *lpDataReady,
+  void     *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000Stop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000PingUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000SetNoOfCaptures)
+(
+  int16_t  handle,
+  uint16_t nCaptures
+);
+
+#endif

+ 1249 - 0
pico-tcp-service/pico-tcp/inc/ps5000aApi.h

@@ -0,0 +1,1249 @@
+/****************************************************************************
+  *
+  * Filename:    ps5000aApi.h
+  * Author:      MAS
+  * Description:
+  *
+  * This header defines the interface to driver routines for the
+  * PicoScope 5000A, B & D Series PC Oscilloscopes.
+  *
+	* Copyright � 2012 - 2022 Pico Technology Ltd. All rights reserved.
+	*
+  ****************************************************************************/
+#ifndef __PS5000AAPI_H__
+#define __PS5000AAPI_H__
+
+#ifdef __GNUC__
+#define DEPRECATED(text, func) func __attribute__ ((deprecated(text)));
+#elif _MSC_VER
+#define DEPRECATED(text, func) __declspec(deprecated(text)) func;
+#else
+#pragma message("WARNING: You need to implement DEPRECATED for this compiler")
+#define DEPRECATED(func) func;
+#endif
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+#include "PicoVersion.h"
+#include "PicoCallback.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+/* If you are dynamically linking ps5000a.dll into your project #define DYNLINK here
+  */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+  #define PREF4 __stdcall
+#else
+
+  /* Define a 64-bit integer type */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+      #define PREF2
+      #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+#define PS5000A_MAX_VALUE_8BIT  32512
+#define PS5000A_MIN_VALUE_8BIT -32512
+
+#define PS5000A_MAX_VALUE_16BIT  32767
+#define PS5000A_MIN_VALUE_16BIT -32767
+
+#define PS5000A_EXT_MAX_VALUE  32767
+#define PS5000A_EXT_MIN_VALUE -32767
+
+// covers the 5242A/B and 5442A/B
+#define PS5X42A_MAX_SIG_GEN_BUFFER_SIZE  16384
+// covers the 5243A/B and 5443A/B
+#define PS5X43A_MAX_SIG_GEN_BUFFER_SIZE  32768
+// covers the 5244A/B and 5444A/B
+#define PS5X44A_MAX_SIG_GEN_BUFFER_SIZE  49152
+
+// covers the PicoScope 5000D Series
+#define PS5X4XD_MAX_SIG_GEN_BUFFER_SIZE  32768
+
+#define MIN_SIG_GEN_BUFFER_SIZE		        1
+#define MIN_DWELL_COUNT				            3
+#define MAX_SWEEPS_SHOTS		((1 << 30) - 1)
+#define	AWG_DAC_FREQUENCY							200e6
+#define	PS5000AB_DDS_FREQUENCY 				200e6
+#define	PS5000D_DDS_FREQUENCY 				100e6
+#define	AWG_PHASE_ACCUMULATOR  4294967296.0
+
+#define MAX_ANALOGUE_OFFSET_50MV_200MV  0.250f
+#define MIN_ANALOGUE_OFFSET_50MV_200MV -0.250f
+#define MAX_ANALOGUE_OFFSET_500MV_2V    2.500f
+#define MIN_ANALOGUE_OFFSET_500MV_2V   -2.500f
+#define MAX_ANALOGUE_OFFSET_5V_20V        20.f
+#define MIN_ANALOGUE_OFFSET_5V_20V       -20.f
+
+#define PS5244A_MAX_ETS_CYCLES 500  // PS5242A, PS5242B, PS5442A, PS5442B
+#define PS5244A_MAX_ETS_INTERLEAVE  40
+
+#define PS5243A_MAX_ETS_CYCLES 250  // PS5243A, PS5243B, PS5443A, PS5443B
+#define PS5243A_MAX_ETS_INTERLEAVE  20
+
+#define PS5242A_MAX_ETS_CYCLES 125    // PS5242A, PS5242B, PS5442A, PS5442B
+#define PS5242A_MAX_ETS_INTERLEAVE  10
+
+
+#define PS5X44D_MAX_ETS_CYCLES      500    // PS5244D, PS5244DMSO, PS5444D, PS5444DMSO
+#define PS5X44D_MAX_ETS_INTERLEAVE  80
+
+#define PS5X43D_MAX_ETS_CYCLES      250    // PS5243D, PS5243DMSO, PS5443D, PS5443DMSO
+#define PS5X43D_MAX_ETS_INTERLEAVE  40
+
+#define PS5X42D_MAX_ETS_CYCLES      125    // PS5242D, PS5242DMSO, PS5442D, PS5442DMSO
+#define PS5X42D_MAX_ETS_INTERLEAVE  5
+
+
+#define PS5000A_SHOT_SWEEP_TRIGGER_CONTINUOUS_RUN 0xFFFFFFFF
+
+typedef enum enPS5000ADeviceResolution
+{
+  PS5000A_DR_8BIT,
+  PS5000A_DR_12BIT,
+  PS5000A_DR_14BIT,
+  PS5000A_DR_15BIT,
+  PS5000A_DR_16BIT
+} PS5000A_DEVICE_RESOLUTION;
+
+typedef enum enPS5000AExtraOperations
+{
+  PS5000A_ES_OFF,
+  PS5000A_WHITENOISE,
+  PS5000A_PRBS // Pseudo-Random Bit Stream
+} PS5000A_EXTRA_OPERATIONS;
+
+typedef enum enPS5000ABandwidthLimiter
+{
+  PS5000A_BW_FULL,
+  PS5000A_BW_20MHZ,
+} PS5000A_BANDWIDTH_LIMITER;
+
+typedef enum enPS5000ACoupling
+{
+  PS5000A_AC,
+  PS5000A_DC
+} PS5000A_COUPLING;
+
+typedef enum enPS5000AChannel
+{
+  PS5000A_CHANNEL_A,
+  PS5000A_CHANNEL_B,
+  PS5000A_CHANNEL_C,
+  PS5000A_CHANNEL_D,
+  PS5000A_EXTERNAL,
+  PS5000A_MAX_CHANNELS = PS5000A_EXTERNAL,
+  PS5000A_TRIGGER_AUX,
+  PS5000A_MAX_TRIGGER_SOURCES,
+
+	PS5000A_DIGITAL_PORT0 = 0x80, // digital channel 0 - 7
+	PS5000A_DIGITAL_PORT1,             // digital channel 8 - 15
+	PS5000A_DIGITAL_PORT2,             // digital channel 16 - 23
+	PS5000A_DIGITAL_PORT3,             // digital channel 24 - 31
+
+	PS5000A_PULSE_WIDTH_SOURCE = 0x10000000
+
+} PS5000A_CHANNEL;
+
+typedef enum enPS5000AChannelFlags
+{
+	PS5000A_CHANNEL_A_FLAGS = 1,
+	PS5000A_CHANNEL_B_FLAGS = 2,
+	PS5000A_CHANNEL_C_FLAGS = 4,
+	PS5000A_CHANNEL_D_FLAGS = 8,
+
+	PS5000A_PORT0_FLAGS = 65536,
+	PS5000A_PORT1_FLAGS = 131072,
+  PS5000A_PORT2_FLAGS = 262144,
+  PS5000A_PORT3_FLAGS = 524288
+
+}	PS5000A_CHANNEL_FLAGS;
+
+typedef enum enPS5000ADigitalChannel
+{
+	PS5000A_DIGITAL_CHANNEL_0,
+	PS5000A_DIGITAL_CHANNEL_1,
+	PS5000A_DIGITAL_CHANNEL_2,
+	PS5000A_DIGITAL_CHANNEL_3,
+	PS5000A_DIGITAL_CHANNEL_4,
+	PS5000A_DIGITAL_CHANNEL_5,
+	PS5000A_DIGITAL_CHANNEL_6,
+	PS5000A_DIGITAL_CHANNEL_7,
+	PS5000A_DIGITAL_CHANNEL_8,
+	PS5000A_DIGITAL_CHANNEL_9,
+	PS5000A_DIGITAL_CHANNEL_10,
+	PS5000A_DIGITAL_CHANNEL_11,
+	PS5000A_DIGITAL_CHANNEL_12,
+	PS5000A_DIGITAL_CHANNEL_13,
+	PS5000A_DIGITAL_CHANNEL_14,
+	PS5000A_DIGITAL_CHANNEL_15,
+	PS5000A_DIGITAL_CHANNEL_16,
+	PS5000A_DIGITAL_CHANNEL_17,
+	PS5000A_DIGITAL_CHANNEL_18,
+	PS5000A_DIGITAL_CHANNEL_19,
+	PS5000A_DIGITAL_CHANNEL_20,
+	PS5000A_DIGITAL_CHANNEL_21,
+	PS5000A_DIGITAL_CHANNEL_22,
+	PS5000A_DIGITAL_CHANNEL_23,
+	PS5000A_DIGITAL_CHANNEL_24,
+	PS5000A_DIGITAL_CHANNEL_25,
+	PS5000A_DIGITAL_CHANNEL_26,
+	PS5000A_DIGITAL_CHANNEL_27,
+	PS5000A_DIGITAL_CHANNEL_28,
+	PS5000A_DIGITAL_CHANNEL_29,
+	PS5000A_DIGITAL_CHANNEL_30,
+	PS5000A_DIGITAL_CHANNEL_31,
+	PS5000A_MAX_DIGITAL_CHANNELS
+} PS5000A_DIGITAL_CHANNEL;
+
+typedef enum enPS5000ADigitalDirection
+{
+	PS5000A_DIGITAL_DONT_CARE,
+	PS5000A_DIGITAL_DIRECTION_LOW,
+	PS5000A_DIGITAL_DIRECTION_HIGH,
+	PS5000A_DIGITAL_DIRECTION_RISING,
+	PS5000A_DIGITAL_DIRECTION_FALLING,
+	PS5000A_DIGITAL_DIRECTION_RISING_OR_FALLING,
+	PS5000A_DIGITAL_MAX_DIRECTION
+} PS5000A_DIGITAL_DIRECTION;
+
+typedef enum enPS5000ARange
+{
+  PS5000A_10MV,
+  PS5000A_20MV,
+  PS5000A_50MV,
+  PS5000A_100MV,
+  PS5000A_200MV,
+  PS5000A_500MV,
+  PS5000A_1V,
+  PS5000A_2V,
+  PS5000A_5V,
+  PS5000A_10V,
+  PS5000A_20V,
+  PS5000A_50V,
+  PS5000A_MAX_RANGES
+} PS5000A_RANGE;
+
+
+typedef enum enPS5000AEtsMode
+{
+  PS5000A_ETS_OFF,             // ETS disabled
+  PS5000A_ETS_FAST,            // Return ready as soon as requested no of interleaves is available
+  PS5000A_ETS_SLOW,            // Return ready every time a new set of no_of_cycles is collected
+  PS5000A_ETS_MODES_MAX
+} PS5000A_ETS_MODE;
+
+typedef enum enPS5000ATimeUnits
+{
+  PS5000A_FS,
+  PS5000A_PS,
+  PS5000A_NS,
+  PS5000A_US,
+  PS5000A_MS,
+  PS5000A_S,
+  PS5000A_MAX_TIME_UNITS,
+} PS5000A_TIME_UNITS;
+
+typedef enum enPS5000ASweepType
+{
+  PS5000A_UP,
+  PS5000A_DOWN,
+  PS5000A_UPDOWN,
+  PS5000A_DOWNUP,
+  PS5000A_MAX_SWEEP_TYPES
+} PS5000A_SWEEP_TYPE;
+
+typedef enum enPS5000AWaveType
+{
+  PS5000A_SINE,
+  PS5000A_SQUARE,
+  PS5000A_TRIANGLE,
+  PS5000A_RAMP_UP,
+  PS5000A_RAMP_DOWN,
+  PS5000A_SINC,
+  PS5000A_GAUSSIAN,
+  PS5000A_HALF_SINE,
+  PS5000A_DC_VOLTAGE,
+  PS5000A_WHITE_NOISE,
+  PS5000A_MAX_WAVE_TYPES
+} PS5000A_WAVE_TYPE;
+
+
+typedef enum enPS5000AConditionsInfo
+{
+	PS5000A_CLEAR = 0x00000001,
+	PS5000A_ADD = 0x00000002
+} PS5000A_CONDITIONS_INFO;
+
+#define PS5000A_SINE_MAX_FREQUENCY       20000000.f
+#define PS5000A_SQUARE_MAX_FREQUENCY     20000000.f
+#define PS5000A_TRIANGLE_MAX_FREQUENCY   20000000.f
+#define PS5000A_SINC_MAX_FREQUENCY       20000000.f
+#define PS5000A_RAMP_MAX_FREQUENCY       20000000.f
+#define PS5000A_HALF_SINE_MAX_FREQUENCY  20000000.f
+#define PS5000A_GAUSSIAN_MAX_FREQUENCY   20000000.f
+#define PS5000A_MIN_FREQUENCY                 0.03f
+
+typedef enum enPS5000ASigGenTrigType
+{
+  PS5000A_SIGGEN_RISING,
+  PS5000A_SIGGEN_FALLING,
+  PS5000A_SIGGEN_GATE_HIGH,
+  PS5000A_SIGGEN_GATE_LOW
+} PS5000A_SIGGEN_TRIG_TYPE;
+
+typedef enum enPS5000ASigGenTrigSource
+{
+  PS5000A_SIGGEN_NONE,
+  PS5000A_SIGGEN_SCOPE_TRIG,
+  PS5000A_SIGGEN_AUX_IN,
+  PS5000A_SIGGEN_EXT_IN,
+  PS5000A_SIGGEN_SOFT_TRIG
+} PS5000A_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPS5000AIndexMode
+{
+  PS5000A_SINGLE,
+  PS5000A_DUAL,
+  PS5000A_QUAD,
+  PS5000A_MAX_INDEX_MODES
+} PS5000A_INDEX_MODE;
+
+typedef enum enPS5000AThresholdMode
+{
+  PS5000A_LEVEL,
+  PS5000A_WINDOW
+} PS5000A_THRESHOLD_MODE;
+
+typedef enum enPS5000AThresholdDirection
+{
+  PS5000A_ABOVE, //using upper threshold
+  PS5000A_BELOW, //using upper threshold
+  PS5000A_RISING, // using upper threshold
+  PS5000A_FALLING, // using upper threshold
+  PS5000A_RISING_OR_FALLING, // using both threshold
+  PS5000A_ABOVE_LOWER, // using lower threshold
+  PS5000A_BELOW_LOWER, // using lower threshold
+  PS5000A_RISING_LOWER,    // using lower threshold
+  PS5000A_FALLING_LOWER,   // using lower threshold
+
+  // Windowing using both thresholds
+  PS5000A_INSIDE = PS5000A_ABOVE,
+  PS5000A_OUTSIDE = PS5000A_BELOW,
+  PS5000A_ENTER = PS5000A_RISING,
+  PS5000A_EXIT = PS5000A_FALLING,
+  PS5000A_ENTER_OR_EXIT = PS5000A_RISING_OR_FALLING,
+  PS5000A_POSITIVE_RUNT = 9,
+   PS5000A_NEGATIVE_RUNT,
+
+  // no trigger set
+  PS5000A_NONE = PS5000A_RISING} PS5000A_THRESHOLD_DIRECTION;
+
+
+typedef enum enPS5000ATriggerState
+{
+  PS5000A_CONDITION_DONT_CARE,
+  PS5000A_CONDITION_TRUE,
+  PS5000A_CONDITION_FALSE,
+  PS5000A_CONDITION_MAX
+} PS5000A_TRIGGER_STATE;
+
+typedef enum enPS5000ATriggerWithinPreTrigger
+{
+  PS5000A_DISABLE,
+  PS5000A_ARM
+} PS5000A_TRIGGER_WITHIN_PRE_TRIGGER;
+
+#pragma pack(push, 1)
+typedef struct tPS5000ATriggerInfo
+{
+	PICO_STATUS		status;
+	uint32_t 	segmentIndex;
+	uint32_t 	triggerIndex;
+	int64_t		triggerTime;
+	int16_t		timeUnits;
+	int16_t		reserved0;
+	uint64_t	timeStampCounter;
+} PS5000A_TRIGGER_INFO;
+
+typedef struct tPS5000ATriggerConditions
+{
+  PS5000A_TRIGGER_STATE channelA;
+  PS5000A_TRIGGER_STATE channelB;
+  PS5000A_TRIGGER_STATE channelC;
+  PS5000A_TRIGGER_STATE channelD;
+  PS5000A_TRIGGER_STATE external;
+  PS5000A_TRIGGER_STATE aux;
+  PS5000A_TRIGGER_STATE pulseWidthQualifier;
+} PS5000A_TRIGGER_CONDITIONS;
+
+typedef struct tPS5000ACondition
+{
+	PS5000A_CHANNEL   		source;
+	PS5000A_TRIGGER_STATE condition;
+} PS5000A_CONDITION;
+
+typedef struct tPS5000ADirection
+{
+	PS5000A_CHANNEL							source;
+	PS5000A_THRESHOLD_DIRECTION direction;
+	PS5000A_THRESHOLD_MODE			mode;
+} PS5000A_DIRECTION;
+
+typedef struct tPS5000APwqConditions
+{
+  PS5000A_TRIGGER_STATE channelA;
+  PS5000A_TRIGGER_STATE channelB;
+  PS5000A_TRIGGER_STATE channelC;
+  PS5000A_TRIGGER_STATE channelD;
+  PS5000A_TRIGGER_STATE external;
+  PS5000A_TRIGGER_STATE aux;
+} PS5000A_PWQ_CONDITIONS;
+
+typedef struct tPS5000AScalingFactors
+{
+	PS5000A_CHANNEL source;
+	PS5000A_RANGE   range;
+	int16_t         offset;
+	double          scalingFactor;
+}PS5000A_SCALING_FACTORS_VALUES;
+
+typedef struct tPS5000ATriggerChannelProperties
+{
+  int16_t                   thresholdUpper;
+  uint16_t          thresholdUpperHysteresis;
+  int16_t                   thresholdLower;
+  uint16_t          thresholdLowerHysteresis;
+  PS5000A_CHANNEL         channel;
+  PS5000A_THRESHOLD_MODE  thresholdMode;
+} PS5000A_TRIGGER_CHANNEL_PROPERTIES;
+
+typedef struct tPS5000ATriggerChannelPropertiesV2
+{
+	int16_t           thresholdUpper;
+	uint16_t          thresholdUpperHysteresis;
+	int16_t                   thresholdLower;
+	uint16_t          thresholdLowerHysteresis;
+	PS5000A_CHANNEL         channel;
+} PS5000A_TRIGGER_CHANNEL_PROPERTIES_V2;
+
+typedef struct tPS5000ADigitalChannelDirections
+{
+	PS5000A_DIGITAL_CHANNEL   channel;
+	PS5000A_DIGITAL_DIRECTION direction;
+} PS5000A_DIGITAL_CHANNEL_DIRECTIONS;
+
+#pragma pack(pop)
+
+typedef enum enPS5000ARatioMode
+{
+  PS5000A_RATIO_MODE_NONE         = 0,
+  PS5000A_RATIO_MODE_AGGREGATE    = 1,
+  PS5000A_RATIO_MODE_DECIMATE     = 2,
+  PS5000A_RATIO_MODE_AVERAGE      = 4,
+  PS5000A_RATIO_MODE_DISTRIBUTION = 8
+} PS5000A_RATIO_MODE;
+
+typedef enum enPS5000APulseWidthType
+{
+  PS5000A_PW_TYPE_NONE,
+  PS5000A_PW_TYPE_LESS_THAN,
+  PS5000A_PW_TYPE_GREATER_THAN,
+  PS5000A_PW_TYPE_IN_RANGE,
+  PS5000A_PW_TYPE_OUT_OF_RANGE
+} PS5000A_PULSE_WIDTH_TYPE;
+
+typedef enum enPS5000AChannelInfo
+{
+  PS5000A_CI_RANGES,
+} PS5000A_CHANNEL_INFO;
+
+
+typedef void (PREF4 *ps5000aBlockReady)
+(
+  int16_t        handle,
+  PICO_STATUS  status,
+  void        *pParameter
+);
+
+typedef void (PREF4 *ps5000aStreamingReady)
+(
+  int16_t          handle,
+  int32_t           noOfSamples,
+  uint32_t  startIndex,
+  int16_t          overflow,
+  uint32_t  triggerAt,
+  int16_t          triggered,
+  int16_t          autoStop,
+  void          *pParameter
+);
+
+typedef void (PREF4 *ps5000aDataReady)
+(
+  int16_t          handle,
+  PICO_STATUS    status,
+  uint32_t  noOfSamples,
+  int16_t          overflow,
+  void          *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aOpenUnit)(
+  int16_t                     *handle,
+  int8_t                      *serial,
+  PS5000A_DEVICE_RESOLUTION  resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aOpenUnitAsync)
+(
+  int16_t                     *status,
+  int8_t                      *serial,
+  PS5000A_DEVICE_RESOLUTION  resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aOpenUnitProgress)
+(
+  int16_t *handle,
+  int16_t *progressPercent,
+  int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetUnitInfo)
+(
+  int16_t      handle,
+  int8_t		*  string,
+  int16_t      stringLength,
+  int16_t     *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aFlashLed)
+(
+  int16_t  handle,
+  int16_t  start
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aIsLedFlashing)
+(
+  int16_t  handle,
+  int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aCloseUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aMemorySegments)
+(
+  int16_t          handle,
+  uint32_t  nSegments,
+  int32_t          *nMaxSamples
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetChannel)
+(
+  int16_t             handle,
+  PS5000A_CHANNEL   channel,
+  int16_t             enabled,
+  PS5000A_COUPLING  type,
+  PS5000A_RANGE     range,
+  float             analogOffset
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetDigitalPort)
+(
+	int16_t                 handle,
+	PS5000A_CHANNEL				  port,
+	int16_t                 enabled,
+	int16_t                 logicLevel
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetBandwidthFilter)
+(
+  int16_t                      handle,
+  PS5000A_CHANNEL            channel,
+  PS5000A_BANDWIDTH_LIMITER  bandwidth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetTimebase)
+(
+  int16_t          handle,
+  uint32_t  timebase,
+  int32_t           noSamples,
+  int32_t          *timeIntervalNanoseconds,
+  int32_t          *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetTimebase2)
+(
+  int16_t          handle,
+  uint32_t  timebase,
+  int32_t           noSamples,
+  float         *timeIntervalNanoseconds,
+  int32_t          *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aNearestSampleIntervalStateless)
+(
+	int16_t   handle,
+	PS5000A_CHANNEL_FLAGS   enabledChannelOrPortFlags,
+	double		timeIntervalRequested,
+	PS5000A_DEVICE_RESOLUTION resolution,
+	uint16_t	useEts,
+	uint32_t	* timebase,
+	double		* timeIntervalAvailable
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aGetMinimumTimebaseStateless)
+(
+	int16_t		handle,
+	PS5000A_CHANNEL_FLAGS		enabledChannelOrPortFlags,
+	uint32_t	* timebase,
+	double		* timeInterval,
+	PS5000A_DEVICE_RESOLUTION resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aChannelCombinationsStateless)
+(
+	int16_t handle,
+	PS5000A_CHANNEL_FLAGS * channelOrPortFlagsCombinations,
+	uint32_t * nChannelCombinations,
+	PS5000A_DEVICE_RESOLUTION resolution,
+	uint32_t timebase,
+	int16_t hasDcPowerSupplyConnected
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetSigGenArbitrary)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  uint32_t               startDeltaPhase,
+  uint32_t               stopDeltaPhase,
+  uint32_t               deltaPhaseIncrement,
+  uint32_t               dwellCount,
+  int16_t                      *arbitraryWaveform,
+  int32_t                        arbitraryWaveformSize,
+  PS5000A_SWEEP_TYPE          sweepType,
+  PS5000A_EXTRA_OPERATIONS    operation,
+  PS5000A_INDEX_MODE          indexMode,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS5000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS5000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetSigGenBuiltIn)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  PS5000A_WAVE_TYPE           waveType,
+  float                       startFrequency,
+  float                       stopFrequency,
+  float                       increment,
+  float                       dwellTime,
+  PS5000A_SWEEP_TYPE          sweepType,
+  PS5000A_EXTRA_OPERATIONS    operation,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS5000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS5000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetSigGenBuiltInV2)
+(
+  int16_t                       handle,
+  int32_t                        offsetVoltage,
+  uint32_t               pkToPk,
+  PS5000A_WAVE_TYPE           waveType,
+  double                       startFrequency,
+  double                       stopFrequency,
+  double                       increment,
+  double                       dwellTime,
+  PS5000A_SWEEP_TYPE          sweepType,
+  PS5000A_EXTRA_OPERATIONS    operation,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS5000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS5000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetSigGenPropertiesArbitrary)
+(
+  int16_t                       handle,
+  uint32_t               startDeltaPhase,
+  uint32_t               stopDeltaPhase,
+  uint32_t               deltaPhaseIncrement,
+  uint32_t               dwellCount,
+  PS5000A_SWEEP_TYPE          sweepType,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS5000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS5000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetSigGenPropertiesBuiltIn)
+(
+  int16_t                       handle,
+	double                       startFrequency,
+	double                       stopFrequency,
+	double                       increment,
+	double                       dwellTime,
+  PS5000A_SWEEP_TYPE          sweepType,
+  uint32_t               shots,
+  uint32_t               sweeps,
+  PS5000A_SIGGEN_TRIG_TYPE    triggerType,
+  PS5000A_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                       extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	PS5000A_INDEX_MODE						indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSigGenSoftwareControl)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetEts)
+(
+  int16_t             handle,
+  PS5000A_ETS_MODE  mode,
+  int16_t             etsCycles,
+  int16_t             etsInterleave,
+  int32_t             *sampleTimePicoseconds
+);
+
+PREF0 DEPRECATED("this function is marked as deprecated use ps5000aSetTriggerChannelPropertiesV2", PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetTriggerChannelProperties)
+(
+	int16_t                               handle,
+	PS5000A_TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+	int16_t                               nChannelProperties,
+	int16_t                               auxOutputEnable,
+	int32_t                                autoTriggerMilliseconds
+	))
+
+	PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetTriggerChannelPropertiesV2)
+	(
+		int16_t																	handle,
+		PS5000A_TRIGGER_CHANNEL_PROPERTIES_V2 *	channelProperties,
+		int16_t																	nChannelProperties,
+		int16_t																	auxOutputEnable
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetAutoTriggerMicroSeconds)
+(
+	int16_t	 handle,
+	uint64_t autoTriggerMicroseconds
+	);
+
+
+PREF0 DEPRECATED("this function is marked as deprecated use ps5000aSetTriggerChannelConditionsV2", PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetTriggerChannelConditions)
+(
+	int16_t                       handle,
+	PS5000A_TRIGGER_CONDITIONS *conditions,
+	int16_t                       nConditions
+	))
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetTriggerChannelConditionsV2)
+(
+	int16_t												handle,
+	PS5000A_CONDITION					*		conditions,
+	int16_t												nConditions,
+	PS5000A_CONDITIONS_INFO				info
+	);
+
+PREF0 DEPRECATED("this function is marked as deprecated use ps5000aSetTriggerChannelDirectionsV2", PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetTriggerChannelDirections)
+(
+  int16_t                      handle,
+  PS5000A_THRESHOLD_DIRECTION  channelA,
+  PS5000A_THRESHOLD_DIRECTION  channelB,
+  PS5000A_THRESHOLD_DIRECTION  channelC,
+  PS5000A_THRESHOLD_DIRECTION  channelD,
+  PS5000A_THRESHOLD_DIRECTION  ext,
+  PS5000A_THRESHOLD_DIRECTION  aux
+))
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetTriggerChannelDirectionsV2)
+(
+	int16_t								handle,
+	PS5000A_DIRECTION	*		directions,
+	uint16_t							nDirections
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetSimpleTrigger)
+(
+  int16_t                        handle,
+  int16_t                        enable,
+  PS5000A_CHANNEL              channel,
+  int16_t                        threshold,
+  PS5000A_THRESHOLD_DIRECTION  direction,
+  uint32_t                delay,
+  int16_t                        autoTrigger_ms
+);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetTriggerDigitalPortProperties)
+(
+	int16_t                               handle,
+	PS5000A_DIGITAL_CHANNEL_DIRECTIONS *  directions,
+	int16_t                               nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetPulseWidthDigitalPortProperties)
+(
+	int16_t                               handle,
+	PS5000A_DIGITAL_CHANNEL_DIRECTIONS *  directions,
+	int16_t                               nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetTriggerDelay)
+(
+   int16_t          handle,
+   uint32_t  delay
+);
+
+PREF0 DEPRECATED("this function is marked as deprecated use ps5000aSetPulseWidthQualifierProperties, ps5000aSetPulseWidthQualifierConditions, ps5000aSetPulseWidthQualifierDirections", PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetPulseWidthQualifier)
+(
+  int16_t                        handle,
+  PS5000A_PWQ_CONDITIONS      *conditions,
+  int16_t                        nConditions,
+  PS5000A_THRESHOLD_DIRECTION  direction,
+  uint32_t                lower,
+  uint32_t                upper,
+  PS5000A_PULSE_WIDTH_TYPE     type
+))
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetPulseWidthQualifierProperties)
+(
+	int16_t														handle,
+	uint32_t										lower,
+	uint32_t										upper,
+	PS5000A_PULSE_WIDTH_TYPE				type
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetPulseWidthQualifierConditions)
+(
+	int16_t												handle,
+	PS5000A_CONDITION					*	conditions,
+	int16_t												nConditions,
+	PS5000A_CONDITIONS_INFO			info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetPulseWidthQualifierDirections)
+(
+	int16_t	handle,
+	PS5000A_DIRECTION * directions,
+	int16_t nDirections
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aIsTriggerOrPulseWidthQualifierEnabled)
+(
+  int16_t  handle,
+  int16_t *triggerEnabled,
+  int16_t *pulseWidthQualifierEnabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetTriggerTimeOffset)
+(
+  int16_t               handle,
+  uint32_t      *timeUpper,
+  uint32_t      *timeLower,
+  PS5000A_TIME_UNITS *timeUnits,
+  uint32_t       segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetTriggerTimeOffset64)
+(
+  int16_t               handle,
+  int64_t            *time,
+  PS5000A_TIME_UNITS *timeUnits,
+  uint32_t       segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesTriggerTimeOffsetBulk)
+(
+  int16_t               handle,
+  uint32_t      *timesUpper,
+  uint32_t      *timesLower,
+  PS5000A_TIME_UNITS *timeUnits,
+  uint32_t       fromSegmentIndex,
+  uint32_t       toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesTriggerTimeOffsetBulk64)
+(
+  int16_t               handle,
+  int64_t            *times,
+  PS5000A_TIME_UNITS *timeUnits,
+  uint32_t       fromSegmentIndex,
+  uint32_t       toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetDataBuffers)
+(
+  int16_t               handle,
+  PS5000A_CHANNEL     source,
+  int16_t              *bufferMax,
+  int16_t              *bufferMin,
+  int32_t                bufferLth,
+  uint32_t       segmentIndex,
+  PS5000A_RATIO_MODE  mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetDataBuffer)
+(
+  int16_t               handle,
+  PS5000A_CHANNEL     source,
+  int16_t              *buffer,
+  int32_t                bufferLth,
+  uint32_t       segmentIndex,
+  PS5000A_RATIO_MODE  mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetUnscaledDataBuffers)
+(
+	int16_t               handle,
+	PS5000A_CHANNEL     source,
+	int8_t              *bufferMax,
+	int8_t              *bufferMin,
+	int32_t                bufferLth,
+	uint32_t      segmentIndex,
+	PS5000A_RATIO_MODE  mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetEtsTimeBuffer)
+(
+  int16_t     handle,
+  int64_t  *buffer,
+  int32_t      bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetEtsTimeBuffers)
+(
+  int16_t          handle,
+  uint32_t *timeUpper,
+  uint32_t *timeLower,
+  int32_t           bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aIsReady)
+(
+		int16_t handle,
+		int16_t * ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aRunBlock)
+(
+  int16_t              handle,
+  int32_t               noOfPreTriggerSamples,
+  int32_t               noOfPostTriggerSamples,
+  uint32_t      timebase,
+  int32_t              *timeIndisposedMs,
+  uint32_t      segmentIndex,
+  ps5000aBlockReady  lpReady,
+  void              *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aRunStreaming)
+(
+  int16_t               handle,
+  uint32_t      *sampleInterval,
+  PS5000A_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t       maxPreTriggerSamples,
+  uint32_t       maxPostTriggerSamples,
+  int16_t               autoStop,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetStreamingLatestValues)
+(
+  int16_t                  handle,
+  ps5000aStreamingReady  lpPs5000aReady,
+  void                  *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aNoOfStreamingValues)
+(
+  int16_t          handle,
+  uint32_t *noOfValues
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetMaxDownSampleRatio)
+(
+  int16_t               handle,
+  uint32_t       noOfUnaggreatedSamples,
+  uint32_t      *maxDownSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValues)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       segmentIndex,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesAsync)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t       noOfSamples,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       segmentIndex,
+  void               *lpDataReady,
+  void               *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesBulk)
+(
+  int16_t               handle,
+  uint32_t      *noOfSamples,
+  uint32_t       fromSegmentIndex,
+  uint32_t       toSegmentIndex,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesOverlapped)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       segmentIndex,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetValuesOverlappedBulk)
+(
+  int16_t               handle,
+  uint32_t       startIndex,
+  uint32_t      *noOfSamples,
+  uint32_t       downSampleRatio,
+  PS5000A_RATIO_MODE  downSampleRatioMode,
+  uint32_t       fromSegmentIndex,
+  uint32_t       toSegmentIndex,
+  int16_t              *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aTriggerWithinPreTriggerSamples)
+(
+  int16_t handle,
+  PS5000A_TRIGGER_WITHIN_PRE_TRIGGER state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetTriggerInfoBulk)
+(
+  int16_t										handle,
+  PS5000A_TRIGGER_INFO	*	triggerInfo,
+  uint32_t						fromSegmentIndex,
+  uint32_t						toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aEnumerateUnits)
+(
+  int16_t *count,
+  int8_t  *serials,
+  int16_t *serialLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetChannelInformation)
+(
+  int16_t                 handle,
+  PS5000A_CHANNEL_INFO  info,
+  int32_t                   probe,
+  int32_t                  *ranges,
+  int32_t                  *length,
+  int32_t                   channels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aMaximumValue)
+(
+  int16_t  handle,
+  int16_t *value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aMinimumValue)
+(
+  int16_t  handle,
+  int16_t * value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetAnalogueOffset)
+(
+  int16_t             handle,
+  PS5000A_RANGE     range,
+  PS5000A_COUPLING  coupling,
+  float            *maximumVoltage,
+  float            *minimumVoltage
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetMaxSegments)
+(
+  int16_t          handle,
+  uint32_t *maxSegments
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aChangePowerSource)
+(
+  int16_t        handle,
+  PICO_STATUS  powerState
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aCurrentPowerSource)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aStop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aPingUnit)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetNoOfCaptures)
+(
+  int16_t          handle,
+  uint32_t  nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetNoOfCaptures)
+(
+  int16_t          handle,
+  uint32_t *nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetNoOfProcessedCaptures)
+(
+  int16_t          handle,
+  uint32_t *nProcessedCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aSetDeviceResolution)
+(
+  int16_t                      handle,
+  PS5000A_DEVICE_RESOLUTION  resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps5000aGetDeviceResolution)
+(
+  int16_t                      handle,
+  PS5000A_DEVICE_RESOLUTION *resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aGetScalingValues)
+(
+	int16_t	handle,
+	PS5000A_SCALING_FACTORS_VALUES *scalingValues,
+	int16_t nChannels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aCheckForUpdate)
+(
+	int16_t	handle,
+	PICO_VERSION * current,
+	PICO_VERSION * update,
+	uint16_t		 * updateRequired
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps5000aStartFirmwareUpdate)
+(
+	int16_t	handle,
+	PicoUpdateFirmwareProgress progress
+);
+
+#endif

+ 962 - 0
pico-tcp-service/pico-tcp/inc/ps6000Api.h

@@ -0,0 +1,962 @@
+/****************************************************************************
+ *
+ * Filename:    ps6000Api.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 6000 Series PC Oscilloscopes.
+ *
+ * Copyright � 2009 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS6000API_H__
+#define __PS6000API_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+// If you are dynamically linking ps6000.dll into your project #define DYNLINK here
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+  #define PREF4 __stdcall
+#else
+
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define PREF4
+#endif
+
+#define PS6000_MAX_OVERSAMPLE_8BIT 256
+
+/* Although the PS6000 uses an 8-bit ADC, it is usually possible to
+ * oversample (collect multiple readings at each time) by up to 256.
+ * the results are therefore ALWAYS scaled up to 16-bits, even if
+ * oversampling is not used.
+ *
+ * The maximum and minimum values returned are therefore as follows:
+ */
+#define PS6000_MAX_VALUE 32512
+#define PS6000_MIN_VALUE -32512
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+
+#define MAX_SIG_GEN_BUFFER_SIZE  16384
+#define PS640X_C_D_MAX_SIG_GEN_BUFFER_SIZE 65536
+
+#define MIN_SIG_GEN_BUFFER_SIZE        1
+#define MIN_DWELL_COUNT                3
+#define MAX_SWEEPS_SHOTS ((1 << 30) - 1)
+
+#define MAX_WAVEFORMS_PER_SECOND  1000000
+
+// supported by the PS6402 and PS6403
+// for other devices use GetAnalogueOffset also
+// PS6402 and PS6403 supports this function
+#define MAX_ANALOGUE_OFFSET_50MV_200MV  0.500f
+#define MIN_ANALOGUE_OFFSET_50MV_200MV -0.500f
+#define MAX_ANALOGUE_OFFSET_500MV_2V    2.500f
+#define MIN_ANALOGUE_OFFSET_500MV_2V   -2.500f
+#define MAX_ANALOGUE_OFFSET_5V_20V        20.f
+#define MIN_ANALOGUE_OFFSET_5V_20V       -20.f
+
+#define PS6000_MAX_ETS_CYCLES 250
+#define PS6000_MAX_INTERLEAVE  50
+
+typedef enum enPS6000ExternalFrequency
+{
+  PS6000_FREQUENCY_OFF,
+  PS6000_FREQUENCY_5MHZ,
+  PS6000_FREQUENCY_10MHZ,
+  PS6000_FREQUENCY_20MHZ,
+  PS6000_FREQUENCY_25MHZ,
+  PS6000_MAX_FREQUENCIES
+} PS6000_EXTERNAL_FREQUENCY;
+
+typedef enum  enPS6000BandwidthLimiter
+{
+  PS6000_BW_FULL,
+  PS6000_BW_20MHZ,
+  PS6000_BW_25MHZ,
+} PS6000_BANDWIDTH_LIMITER;
+
+typedef enum enPS6000Channel
+{
+  PS6000_CHANNEL_A,
+  PS6000_CHANNEL_B,
+  PS6000_CHANNEL_C,
+  PS6000_CHANNEL_D,
+  PS6000_EXTERNAL,
+  PS6000_MAX_CHANNELS = PS6000_EXTERNAL,
+  PS6000_TRIGGER_AUX,
+  PS6000_MAX_TRIGGER_SOURCES
+}  PS6000_CHANNEL;
+
+typedef enum enPS6000ChannelBufferIndex
+{
+  PS6000_CHANNEL_A_MAX,
+  PS6000_CHANNEL_A_MIN,
+  PS6000_CHANNEL_B_MAX,
+  PS6000_CHANNEL_B_MIN,
+  PS6000_CHANNEL_C_MAX,
+  PS6000_CHANNEL_C_MIN,
+  PS6000_CHANNEL_D_MAX,
+  PS6000_CHANNEL_D_MIN,
+  PS6000_MAX_CHANNEL_BUFFERS
+} PS6000_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS6000Range
+{
+  PS6000_10MV,
+  PS6000_20MV,
+  PS6000_50MV,
+  PS6000_100MV,
+  PS6000_200MV,
+  PS6000_500MV,
+  PS6000_1V,
+  PS6000_2V,
+  PS6000_5V,
+  PS6000_10V,
+  PS6000_20V,
+  PS6000_50V,
+  PS6000_MAX_RANGES
+}  PS6000_RANGE;
+
+
+typedef enum enPS6000Coupling
+{
+  PS6000_AC,
+  PS6000_DC_1M,
+  PS6000_DC_50R
+} PS6000_COUPLING;
+
+typedef enum enPS6000EtsMode
+{
+  PS6000_ETS_OFF,             // ETS disabled
+  PS6000_ETS_FAST,            // Return ready as soon as requested no of interleaves is available
+  PS6000_ETS_SLOW,            // Return ready every time a new set of no_of_cycles is collected
+  PS6000_ETS_MODES_MAX
+}  PS6000_ETS_MODE;
+
+typedef enum enPS6000TimeUnits
+{
+  PS6000_FS,
+  PS6000_PS,
+  PS6000_NS,
+  PS6000_US,
+  PS6000_MS,
+  PS6000_S,
+  PS6000_MAX_TIME_UNITS,
+}  PS6000_TIME_UNITS;
+
+typedef enum enPS6000SweepType
+{
+  PS6000_UP,
+  PS6000_DOWN,
+  PS6000_UPDOWN,
+  PS6000_DOWNUP,
+  PS6000_MAX_SWEEP_TYPES
+} PS6000_SWEEP_TYPE;
+
+typedef enum enPS6000WaveType
+{
+  PS6000_SINE,
+  PS6000_SQUARE,
+  PS6000_TRIANGLE,
+  PS6000_RAMP_UP,
+  PS6000_RAMP_DOWN,
+  PS6000_SINC,
+  PS6000_GAUSSIAN,
+  PS6000_HALF_SINE,
+  PS6000_DC_VOLTAGE,
+  PS6000_MAX_WAVE_TYPES
+} PS6000_WAVE_TYPE;
+
+typedef enum enPS6000ExtraOperations
+{
+  PS6000_ES_OFF,
+  PS6000_WHITENOISE,
+  PS6000_PRBS // Pseudo-Random Bit Stream
+} PS6000_EXTRA_OPERATIONS;
+
+#define PS6000_PRBS_MAX_FREQUENCY       20000000.f
+#define PS6000_SINE_MAX_FREQUENCY       20000000.f
+#define PS6000_SQUARE_MAX_FREQUENCY     20000000.f
+#define PS6000_TRIANGLE_MAX_FREQUENCY   20000000.f
+#define PS6000_SINC_MAX_FREQUENCY       20000000.f
+#define PS6000_RAMP_MAX_FREQUENCY       20000000.f
+#define PS6000_HALF_SINE_MAX_FREQUENCY  20000000.f
+#define PS6000_GAUSSIAN_MAX_FREQUENCY   20000000.f
+#define PS6000_MIN_FREQUENCY                 0.03f
+
+typedef enum enPS6000SigGenTrigType
+{
+  PS6000_SIGGEN_RISING,
+  PS6000_SIGGEN_FALLING,
+  PS6000_SIGGEN_GATE_HIGH,
+  PS6000_SIGGEN_GATE_LOW
+} PS6000_SIGGEN_TRIG_TYPE;
+
+typedef enum enPS6000SigGenTrigSource
+{
+  PS6000_SIGGEN_NONE,
+  PS6000_SIGGEN_SCOPE_TRIG,
+  PS6000_SIGGEN_AUX_IN,
+  PS6000_SIGGEN_EXT_IN,
+  PS6000_SIGGEN_SOFT_TRIG,
+  PS6000_SIGGEN_TRIGGER_RAW
+} PS6000_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPS6000IndexMode
+{
+  PS6000_SINGLE,
+  PS6000_DUAL,
+  PS6000_QUAD,
+  PS6000_MAX_INDEX_MODES
+} PS6000_INDEX_MODE;
+
+typedef enum enPS6000ThresholdMode
+{
+  PS6000_LEVEL,
+  PS6000_WINDOW
+} PS6000_THRESHOLD_MODE;
+
+typedef enum enPS6000ThresholdDirection
+{
+  PS6000_ABOVE,             //using upper threshold
+  PS6000_BELOW,							// using upper threshold
+  PS6000_RISING,            // using upper threshold
+  PS6000_FALLING,           // using upper threshold
+  PS6000_RISING_OR_FALLING, // using upper threshold
+  PS6000_ABOVE_LOWER,       // using lower threshold
+  PS6000_BELOW_LOWER,       // using lower threshold
+  PS6000_RISING_LOWER,      // using lower threshold
+  PS6000_FALLING_LOWER,     // using lower threshold
+  // Windowing using both thresholds
+  PS6000_INSIDE        = PS6000_ABOVE,
+  PS6000_OUTSIDE       = PS6000_BELOW,
+  PS6000_ENTER         = PS6000_RISING,
+  PS6000_EXIT          = PS6000_FALLING,
+  PS6000_ENTER_OR_EXIT = PS6000_RISING_OR_FALLING,
+  PS6000_POSITIVE_RUNT = 9,
+  PS6000_NEGATIVE_RUNT,
+  // no trigger set
+  PS6000_NONE = PS6000_RISING
+} PS6000_THRESHOLD_DIRECTION;
+
+typedef enum enPS6000TriggerState
+{
+  PS6000_CONDITION_DONT_CARE,
+  PS6000_CONDITION_TRUE,
+  PS6000_CONDITION_FALSE,
+  PS6000_CONDITION_MAX
+} PS6000_TRIGGER_STATE;
+
+#pragma pack(push,1)
+typedef struct tPS6000TriggerInfo
+{
+	PICO_STATUS	status;
+	uint32_t	segmentIndex;
+	uint32_t	triggerIndex;
+	int64_t		triggerTime;
+	int16_t		timeUnits;
+	int16_t		reserved0;
+	uint64_t	timeStampCounter;
+} PS6000_TRIGGER_INFO;
+
+typedef struct tPS6000TriggerConditions
+{
+  PS6000_TRIGGER_STATE channelA;
+  PS6000_TRIGGER_STATE channelB;
+  PS6000_TRIGGER_STATE channelC;
+  PS6000_TRIGGER_STATE channelD;
+  PS6000_TRIGGER_STATE external;
+  PS6000_TRIGGER_STATE aux;
+  PS6000_TRIGGER_STATE pulseWidthQualifier;
+} PS6000_TRIGGER_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS6000PwqConditions
+{
+  PS6000_TRIGGER_STATE channelA;
+  PS6000_TRIGGER_STATE channelB;
+  PS6000_TRIGGER_STATE channelC;
+  PS6000_TRIGGER_STATE channelD;
+  PS6000_TRIGGER_STATE external;
+  PS6000_TRIGGER_STATE aux;
+} PS6000_PWQ_CONDITIONS;
+#pragma pack(pop)
+
+#pragma pack(push,1)
+typedef struct tPS6000TriggerChannelProperties
+{
+  int16_t            thresholdUpper;
+  uint16_t  hysteresisUpper;
+  int16_t            thresholdLower;
+  uint16_t  hysteresisLower;
+  PS6000_CHANNEL  channel;
+  PS6000_THRESHOLD_MODE  thresholdMode;
+} PS6000_TRIGGER_CHANNEL_PROPERTIES;
+#pragma pack(pop)
+
+typedef enum enPS6000RatioMode
+{
+  PS6000_RATIO_MODE_NONE,
+  PS6000_RATIO_MODE_AGGREGATE    = 1,
+  PS6000_RATIO_MODE_AVERAGE      = 2,
+  PS6000_RATIO_MODE_DECIMATE     = 4,
+  PS6000_RATIO_MODE_DISTRIBUTION = 8
+} PS6000_RATIO_MODE;
+
+typedef enum enPS6000PulseWidthType
+{
+  PS6000_PW_TYPE_NONE,
+  PS6000_PW_TYPE_LESS_THAN,
+  PS6000_PW_TYPE_GREATER_THAN,
+  PS6000_PW_TYPE_IN_RANGE,
+  PS6000_PW_TYPE_OUT_OF_RANGE
+} PS6000_PULSE_WIDTH_TYPE;
+
+typedef enum enPS6000Temperatures
+{
+	PS6000_WHAT_ARE_AVAILABLE = 0,
+	PS6000_INTERNAL_TEMPERATURE = 1
+} PS6000_TEMPERATURES;
+
+typedef void (PREF4 *ps6000BlockReady)
+(
+  int16_t        handle,
+  PICO_STATUS  status,
+  void        *pParameter
+);
+
+typedef void (PREF4 *ps6000StreamingReady)
+(
+  int16_t          handle,
+  uint32_t  noOfSamples,
+  uint32_t  startIndex,
+  int16_t          overflow,
+  uint32_t  triggerAt,
+  int16_t          triggered,
+  int16_t          autoStop,
+  void          *pParameter
+);
+
+typedef void (PREF4 *ps6000DataReady)
+(
+  int16_t          handle,
+  PICO_STATUS    status,
+  uint32_t  noOfSamples,
+  int16_t          overflow,
+  void          *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000OpenUnit)
+(
+  int16_t *handle,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000OpenUnitAsync)
+(
+  int16_t *status,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000OpenUnitProgress)
+(
+  int16_t *handle,
+  int16_t *progressPercent,
+  int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetUnitInfo)
+(
+  int16_t      handle,
+  int8_t      *string,
+  int16_t      stringLength,
+  int16_t     *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000FlashLed)
+(
+  int16_t  handle,
+  int16_t  start
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000CloseUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000MemorySegments)
+(
+  int16_t          handle,
+  uint32_t  nSegments,
+  uint32_t *nMaxSamples
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetChannel)
+(
+  int16_t                     handle,
+  PS6000_CHANNEL            channel,
+  int16_t                     enabled,
+  PS6000_COUPLING           type,
+  PS6000_RANGE              range,
+  float                     analogueOffset,
+  PS6000_BANDWIDTH_LIMITER  bandwidth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetTimebase)
+(
+  int16_t          handle,
+  uint32_t  timebase,
+  uint32_t  noSamples,
+  int32_t          *timeIntervalNanoseconds,
+  int16_t          oversample,
+  uint32_t *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetTimebase2)
+(
+  int16_t          handle,
+  uint32_t  timebase,
+  uint32_t  noSamples,
+  float         *timeIntervalNanoseconds,
+  int16_t          oversample,
+  uint32_t *maxSamples,
+  uint32_t  segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetSigGenArbitrary)
+(
+  int16_t                      handle,
+  int32_t                       offsetVoltage,
+  uint32_t              pkToPk,
+  uint32_t              startDeltaPhase,
+  uint32_t              stopDeltaPhase,
+  uint32_t              deltaPhaseIncrement,
+  uint32_t              dwellCount,
+  int16_t                     *arbitraryWaveform,
+  int32_t                       arbitraryWaveformSize,
+  PS6000_SWEEP_TYPE          sweepType,
+  PS6000_EXTRA_OPERATIONS    operation,
+  PS6000_INDEX_MODE          indexMode,
+  uint32_t              shots,
+  uint32_t              sweeps,
+  PS6000_SIGGEN_TRIG_TYPE    triggerType,
+  PS6000_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                      extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SetSigGenBuiltIn)
+(
+  int16_t                      handle,
+  int32_t                       offsetVoltage,
+  uint32_t              pkToPk,
+  int16_t                      waveType,
+  float                      startFrequency,
+  float                      stopFrequency,
+  float                      increment,
+  float                      dwellTime,
+  PS6000_SWEEP_TYPE          sweepType,
+  PS6000_EXTRA_OPERATIONS    operation,
+  uint32_t              shots,
+  uint32_t              sweeps,
+  PS6000_SIGGEN_TRIG_TYPE    triggerType,
+  PS6000_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                      extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SetSigGenBuiltInV2)
+(
+	int16_t										handle,
+	int32_t										offsetVoltage,
+	uint32_t									pkToPk,
+	int16_t 									waveType,
+	double 										startFrequency,
+	double										stopFrequency,
+	double 										increment,
+	double 										dwellTime,
+	PS6000_SWEEP_TYPE					sweepType,
+	PS6000_EXTRA_OPERATIONS		operation,
+	uint32_t									shots,
+	uint32_t									sweeps,
+	PS6000_SIGGEN_TRIG_TYPE		triggerType,
+	PS6000_SIGGEN_TRIG_SOURCE triggerSource,
+	int16_t										extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetSigGenPropertiesArbitrary)
+(
+  int16_t                      handle,
+  int32_t                       offsetVoltage,
+  uint32_t              pkToPk,
+  uint32_t              startDeltaPhase,
+  uint32_t              stopDeltaPhase,
+  uint32_t              deltaPhaseIncrement,
+  uint32_t              dwellCount,
+  PS6000_SWEEP_TYPE          sweepType,
+  uint32_t              shots,
+  uint32_t              sweeps,
+  PS6000_SIGGEN_TRIG_TYPE    triggerType,
+  PS6000_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                      extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SetSigGenPropertiesBuiltIn)
+(
+  int16_t                      handle,
+  int32_t                       offsetVoltage,
+  uint32_t              pkToPk,
+  double                      startFrequency,
+  double                      stopFrequency,
+  double                      increment,
+  double                      dwellTime,
+  PS6000_SWEEP_TYPE          sweepType,
+  uint32_t              shots,
+  uint32_t              sweeps,
+  PS6000_SIGGEN_TRIG_TYPE    triggerType,
+  PS6000_SIGGEN_TRIG_SOURCE  triggerSource,
+  int16_t                      extInThreshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SigGenFrequencyToPhase)
+	(
+	int16_t												handle,
+	double												frequency,
+	PS6000_INDEX_MODE							indexMode,
+	uint32_t											bufferLength,
+	uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t  * minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SigGenSoftwareControl)
+(
+  int16_t  handle,
+  int16_t  state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetSimpleTrigger)
+(
+  int16_t                       handle,
+  int16_t                       enable,
+  PS6000_CHANNEL              source,
+  int16_t                       threshold,
+  PS6000_THRESHOLD_DIRECTION  direction,
+  uint32_t               delay,
+  int16_t                       autoTrigger_ms
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetEts)
+(
+  int16_t            handle,
+  PS6000_ETS_MODE  mode,
+  int16_t            etsCycles,
+  int16_t            etsInterleave,
+  int32_t            *sampleTimePicoseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetTriggerChannelProperties)
+(
+  int16_t                              handle,
+  PS6000_TRIGGER_CHANNEL_PROPERTIES *channelProperties,
+  int16_t                              nChannelProperties,
+  int16_t                              auxOutputEnable,
+  int32_t                               autoTriggerMilliseconds
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetTriggerChannelConditions)
+(
+  int16_t                      handle,
+  PS6000_TRIGGER_CONDITIONS *conditions,
+  int16_t                      nConditions
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetTriggerChannelDirections)
+(
+  int16_t                       handle,
+  PS6000_THRESHOLD_DIRECTION  channelA,
+  PS6000_THRESHOLD_DIRECTION  channelB,
+  PS6000_THRESHOLD_DIRECTION  channelC,
+  PS6000_THRESHOLD_DIRECTION  channelD,
+  PS6000_THRESHOLD_DIRECTION  ext,
+  PS6000_THRESHOLD_DIRECTION  aux
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetTriggerDelay)
+(
+  int16_t          handle,
+  uint32_t  delay
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetPulseWidthQualifier)
+(
+  int16_t                       handle,
+  PS6000_PWQ_CONDITIONS      *conditions,
+  int16_t                       nConditions,
+  PS6000_THRESHOLD_DIRECTION  direction,
+  uint32_t               lower,
+  uint32_t               upper,
+  PS6000_PULSE_WIDTH_TYPE     type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000IsTriggerOrPulseWidthQualifierEnabled)
+(
+  int16_t  handle,
+  int16_t *triggerEnabled,
+  int16_t *pulseWidthQualifierEnabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetTriggerTimeOffset)
+(
+  int16_t              handle,
+  uint32_t     *timeUpper,
+  uint32_t     *timeLower,
+  PS6000_TIME_UNITS *timeUnits,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetTriggerTimeOffset64)
+(
+  int16_t              handle,
+  int64_t           *time,
+  PS6000_TIME_UNITS *timeUnits,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesTriggerTimeOffsetBulk)
+(
+  int16_t              handle,
+  uint32_t     *timesUpper,
+  uint32_t     *timesLower,
+  PS6000_TIME_UNITS *timeUnits,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesTriggerTimeOffsetBulk64)
+(
+  int16_t              handle,
+  int64_t           *times,
+  PS6000_TIME_UNITS *timeUnits,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetDataBuffers)
+(
+  int16_t             handle,
+  PS6000_CHANNEL    channel,
+  int16_t            *bufferMax,
+  int16_t            *bufferMin,
+  uint32_t     bufferLth,
+  PS6000_RATIO_MODE downSampleRatioMode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetDataBuffer)
+(
+  int16_t              handle,
+  PS6000_CHANNEL     channel,
+  int16_t             *buffer,
+  uint32_t      bufferLth,
+  PS6000_RATIO_MODE  downSampleRatioMode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetDataBufferBulk)
+(
+  int16_t              handle,
+  PS6000_CHANNEL     channel,
+  int16_t             *buffer,
+  uint32_t      bufferLth,
+  uint32_t      waveform,
+  PS6000_RATIO_MODE  downSampleRatioMode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetDataBuffersBulk)
+(
+  int16_t              handle,
+  PS6000_CHANNEL     channel,
+  int16_t             *bufferMax,
+  int16_t             *bufferMin,
+  uint32_t      bufferLth,
+  uint32_t      waveform,
+  PS6000_RATIO_MODE  downSampleRatioMode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetEtsTimeBuffer)
+(
+  int16_t          handle,
+  int64_t       *buffer,
+  uint32_t  bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetEtsTimeBuffers)
+(
+  int16_t          handle,
+  uint32_t *timeUpper,
+  uint32_t *timeLower,
+  uint32_t  bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000RunBlock)
+(
+  int16_t             handle,
+  uint32_t     noOfPreTriggerSamples,
+  uint32_t     noOfPostTriggerSamples,
+  uint32_t     timebase,
+  int16_t             oversample,
+  int32_t             *timeIndisposedMs,
+  uint32_t     segmentIndex,
+  ps6000BlockReady  lpReady,
+  void             *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000IsReady)
+(
+  int16_t  handle,
+  int16_t *ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000RunStreaming)
+(
+  int16_t              handle,
+  uint32_t     *sampleInterval,
+  PS6000_TIME_UNITS  sampleIntervalTimeUnits,
+  uint32_t      maxPreTriggerSamples,
+  uint32_t      maxPostPreTriggerSamples,
+  int16_t              autoStop,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      overviewBufferSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetStreamingLatestValues)
+(
+  int16_t                 handle,
+  ps6000StreamingReady  lpPs6000Ready,
+  void                 *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000NoOfStreamingValues)
+(
+  int16_t          handle,
+  uint32_t *noOfValues
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetMaxDownSampleRatio)
+(
+  int16_t              handle,
+  uint32_t      noOfUnaggreatedSamples,
+  uint32_t     *maxDownSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValues)
+(
+  int16_t              handle,
+  uint32_t      startIndex,
+  uint32_t     *noOfSamples,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex,
+  int16_t             *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesBulk)
+(
+  int16_t              handle,
+  uint32_t     *noOfSamples,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  int16_t             *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesAsync)
+(
+  int16_t              handle,
+  uint32_t      startIndex,
+  uint32_t      noOfSamples,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex,
+  void              *lpDataReady,
+  void              *pParameter
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesOverlapped)
+(
+  int16_t              handle,
+  uint32_t      startIndex,
+  uint32_t     *noOfSamples,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      segmentIndex,
+  int16_t             *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesOverlappedBulk)
+(
+  int16_t              handle,
+  uint32_t      startIndex,
+  uint32_t     *noOfSamples,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex,
+  int16_t             *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetValuesBulkAsyc)
+(
+  int16_t              handle,
+  uint32_t      startIndex,
+  uint32_t     *noOfSamples,
+  uint32_t      downSampleRatio,
+  PS6000_RATIO_MODE  downSampleRatioMode,
+  uint32_t      fromSegmentIndex,
+  uint32_t      toSegmentIndex,
+  int16_t             *overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetNoOfCaptures)
+(
+  int16_t          handle,
+  uint32_t *nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetNoOfProcessedCaptures)
+(
+  int16_t          handle,
+  uint32_t *nProcessedCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000Stop)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetNoOfCaptures)
+(
+  int16_t          handle,
+  uint32_t  nCaptures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetWaveformLimiter)
+(
+  int16_t          handle,
+  uint32_t  nWaveformsPerSecond
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000GetTriggerInfoBulk)
+(
+	int16_t										handle,
+	PS6000_TRIGGER_INFO			*	triggerInfo,
+	uint32_t									fromSegmentIndex,
+	uint32_t									toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000EnumerateUnits)
+(
+  int16_t *count,
+  int8_t  *serials,
+  int16_t *serialLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000SetExternalClock)
+(
+  int16_t                      handle,
+  PS6000_EXTERNAL_FREQUENCY  frequency,
+  int16_t                      threshold
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000PingUnit)
+(
+  int16_t  handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000GetAnalogueOffset)
+(
+  int16_t            handle,
+  PS6000_RANGE     range,
+  PS6000_COUPLING  coupling,
+  float           *maximumVoltage,
+  float           *minimumVoltage
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000QueryTemperatures)
+(
+	int16_t					handle,
+	PS6000_TEMPERATURES * types,
+	float * temperatures
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000QueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000SetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+);
+#endif

+ 765 - 0
pico-tcp-service/pico-tcp/inc/ps6000aApi.h

@@ -0,0 +1,765 @@
+/****************************************************************************
+ *
+ * Filename:    ps6000aApi.h
+ * Copyright:   Pico Technology Limited 2002 - 2022
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 6000 range of PC Oscilloscopes.
+ *
+ ****************************************************************************/
+#ifndef __PS6000AAPI_H__
+#define __PS6000AAPI_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+#include "PicoDeviceEnums.h"
+#include "PicoDeviceStructs.h"
+#include "PicoCallback.h"
+#include "PicoVersion.h"
+
+#ifdef __cplusplus
+#define PREF0 extern "C"
+#define TYPE_ENUM
+#else
+#define PREF0
+#define TYPE_ENUM enum
+#endif
+
+
+#ifdef WIN32
+	#ifdef PREF1
+		#undef PREF1
+	#endif
+	#ifdef PREF2
+		#undef PREF2
+	#endif
+	#ifdef PREF3
+		#undef PREF3
+	#endif
+	 //If you are dynamically linking PS6000A.DLL into your project #define DYNLINK here>
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (__stdcall *x)
+	#else
+		#define PREF1
+	#ifdef _USRDLL
+		#define PREF2 __declspec(dllexport) __stdcall
+	#else
+		#define PREF2 __declspec(dllimport) __stdcall
+	#endif
+		#define PREF3(x) x
+	#endif
+	#define PREF4 __stdcall
+#else
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+#define PREF4
+#endif
+
+typedef void (PREF4 *ps6000aBlockReady)
+(
+	int16_t				handle,
+	PICO_STATUS		status,
+	PICO_POINTER	pParameter
+	);
+
+typedef void (PREF4 *ps6000aDataReady)
+(
+	int16_t    					handle,
+	PICO_STATUS					status,
+	uint64_t     				noOfSamples,
+	int16_t    					overflow,
+	PICO_POINTER				pParameter
+	);
+
+typedef void (PREF4 *ps6000aProbeInteractions)
+(
+	int16_t    											handle,
+	PICO_STATUS											status,
+	PICO_USER_PROBE_INTERACTIONS *	probes,
+	uint32_t												nProbes
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000aOpenUnit)
+(
+	int16_t										*	handle,
+	int8_t										*	serial,
+	PICO_DEVICE_RESOLUTION		resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000aOpenUnitAsync)
+(
+	int16_t										*	status,
+	int8_t										*	serial,
+	PICO_DEVICE_RESOLUTION		resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000aOpenUnitProgress)
+(
+	int16_t *	handle,
+	int16_t *	progressPercent,
+	int16_t *	complete
+);
+
+// This function retrieves information about the specified oscilloscope or driver software.
+// If the device fails to open or no device is opened, it is still possible to read the driver version.
+//
+// parameters:
+// handle: identifies the device from which information is required. If an invalid handle is passed, only the driver versions can be read.
+// string: on exit, the unit information string selected specified by the info argument. If string is NULL, only requiredSize is returned.
+// stringLength: the maximum number of 8-bit integers (int8_t) that may be written to string.
+// requiredSize: on exit, the required length of the string array.
+// info: a number specifying what information is required.
+//
+// return:
+// PICO_OK
+// PICO_INVALID_HANDLE
+// PICO_NULL_PARAMETER
+// PICO_INVALID_INFO
+// PICO_INFO_UNAVAILABLE
+// PICO_DRIVER_FUNCTION
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetUnitInfo)
+(
+	int16_t				handle,
+	int8_t			*	string,
+	int16_t				stringLength,
+	int16_t     *	requiredSize,
+	PICO_INFO			info
+);
+
+// This function retrieves information about the accessory (probe, or MSO Pod) attached to the specified channel.
+// Note: you must set a probe interaction callback to be able to retrieve probe information.
+//
+// parameters:
+// handle: identifies the device to which the accessory is attached.
+// channel: identifies the channel to which the accessory is attached. If no accessory is connected to this channel, an error will result.
+// string: on exit, the accessory information string selected specified by the info argument. If string is NULL, only requiredSize is returned.
+// stringLength: the maximum number of 8-bit integers (int8_t) that may be written to string.
+// requiredSize: on exit, the required length of the string array.
+// info: a number specifying what information is required. Note that unlike ps6000aGetUnitInfo, only PICO_BATCH_AND_SERIAL and PICO_CAL_DATE are valid for accessories.
+//
+// return:
+// PICO_OK
+// PICO_INVALID_HANDLE (handle isn't that of an open PicoScope device.)
+// PICO_PROBE_COLLECTION_NOT_STARTED (handle hasn't got a probe interaction callback set).
+// PICO_INVALID_CHANNEL (channel doesn't map to a channel on the device with handle.)
+// PICO_NULL_PARAMETER (requiredSize is NULL.)
+// PICO_INVALID_INFO (info is an invalid value for the attached accessory.)
+// PICO_NOT_SUPPORTED_BY_THIS_DEVICE (no accessory is connected, or the connected accessory does not support any info.)
+// PICO_DRIVER_FUNCTION (another thread is already calling a driver function.)
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetAccessoryInfo)
+(
+	int16_t				handle,
+	PICO_CHANNEL	channel,
+	int8_t			* string,
+	int16_t				stringLength,
+	int16_t			* requiredSize,
+	PICO_INFO			info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps6000aCloseUnit)
+(
+	int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aFlashLed)
+(
+	int16_t handle,
+	int16_t start
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aMemorySegments)
+(
+	int16_t     handle,
+	uint64_t		nSegments,
+	uint64_t *	nMaxSamples
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aMemorySegmentsBySamples)
+(
+	int16_t			handle,
+	uint64_t 		nSamples,
+	uint64_t	* nMaxSegments
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetMaximumAvailableMemory)
+(
+	int16_t     handle,
+	uint64_t *	nMaxSamples,
+	PICO_DEVICE_RESOLUTION resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aQueryMaxSegmentsBySamples)
+(
+	int16_t handle,
+	uint64_t nSamples,
+	uint32_t nChannelEnabled,
+	uint64_t * nMaxSegments,
+	PICO_DEVICE_RESOLUTION resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetChannelOn)
+(
+	int16_t                       handle,
+	PICO_CHANNEL                  channel,
+	PICO_COUPLING                 coupling,
+	PICO_CONNECT_PROBE_RANGE      range,
+	double                        analogueOffset,
+	PICO_BANDWIDTH_LIMITER        bandwidth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetChannelOff)
+(
+  int16_t                       handle,
+  PICO_CHANNEL                  channel
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDigitalPortOn)
+(
+	int16_t					              handle,
+	PICO_CHANNEL		              port,
+	int16_t *				              logicThresholdLevel,
+	int16_t					              logicThresholdLevelLength,
+	PICO_DIGITAL_PORT_HYSTERESIS  hysteresis
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDigitalPortOff)
+(
+  int16_t					              handle,
+  PICO_CHANNEL		              port
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetTimebase)
+(
+	int16_t         handle,
+	uint32_t				timebase,
+	uint64_t				noSamples,
+	double        *	timeIntervalNanoseconds,
+	uint64_t			*	maxSamples,
+	uint64_t			  segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenWaveform)
+(
+	int16_t						handle,
+	PICO_WAVE_TYPE		waveType,
+	int16_t					* buffer,
+	uint64_t					bufferLength
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenRange)
+(
+	int16_t         handle,
+	double          peakToPeakVolts,
+	double          offsetVolts
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenWaveformDutyCycle)
+(
+	int16_t					handle,
+	double				  dutyCyclePercent
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenTrigger)
+(
+	int16_t											handle,
+	PICO_SIGGEN_TRIG_TYPE				triggerType,
+	PICO_SIGGEN_TRIG_SOURCE			triggerSource,
+	uint64_t										cycles,
+	uint64_t                    autoTriggerPicoSeconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenFilter)
+(
+	int16_t											handle,
+	PICO_SIGGEN_FILTER_STATE		filterState
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenFrequency)
+(
+	int16_t							handle,
+	double							frequencyHz
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenFrequencySweep)
+(
+	int16_t							handle,
+	double						  stopFrequencyHz,
+	double							frequencyIncrement,
+	double							dwellTimeSeconds,
+	PICO_SWEEP_TYPE			sweepType
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenPhase)
+(
+	int16_t							handle,
+	uint64_t						deltaPhase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenPhaseSweep)
+(
+	int16_t							handle,
+	uint64_t						stopDeltaPhase,
+	uint64_t						deltaPhaseIncrement,
+	uint64_t						dwellCount,
+	PICO_SWEEP_TYPE			sweepType
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenClockManual)
+(
+	int16_t							handle,
+	double							dacClockFrequency,
+	uint64_t						prescaleRatio
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenSoftwareTriggerControl)
+(
+	int16_t										handle,
+	PICO_SIGGEN_TRIG_TYPE			triggerState
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenApply)
+(
+	int16_t							handle,
+	int16_t             sigGenEnabled,
+	int16_t             sweepEnabled,
+	int16_t             triggerEnabled,
+	int16_t							automaticClockOptimisationEnabled,
+  int16_t             overrideAutomaticClockAndPrescale,
+	double						* frequency,
+	double						* stopFrequency,
+	double						* frequencyIncrement,
+	double						* dwellTime
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenLimits)
+(
+	int16_t							     handle,
+	PICO_SIGGEN_PARAMETER    parameter,
+	double                 * minimumPermissibleValue,
+	double                 * maximumPermissibleValue,
+	double                 * step
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenFrequencyLimits)
+(
+	int16_t							     handle,
+  PICO_WAVE_TYPE           waveType,
+  uint64_t               * numSamples,
+  double                 * startFrequency,
+  int16_t                  sweepEnabled,
+  double                 * manualDacClockFrequency,
+  uint64_t               * manualPrescaleRatio,
+  double                 * maxStopFrequencyOut,
+  double                 * minFrequencyStepOut,
+  double                 * maxFrequencyStepOut,
+  double                 * minDwellTimeOut,
+  double                 * maxDwellTimeOut
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenPause)
+(
+	int16_t										handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSigGenRestart)
+(
+	int16_t										handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetSimpleTrigger)
+(
+	int16_t                   handle,
+	int16_t                   enable,
+	PICO_CHANNEL              source,
+	int16_t                   threshold,
+	PICO_THRESHOLD_DIRECTION  direction,
+	uint64_t									delay,
+	uint32_t                  autoTriggerMicroSeconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aTriggerWithinPreTriggerSamples)
+(
+  int16_t handle,
+  PICO_TRIGGER_WITHIN_PRE_TRIGGER state
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTriggerChannelProperties)
+(
+	int16_t                           handle,
+	PICO_TRIGGER_CHANNEL_PROPERTIES *	channelProperties,
+	int16_t                           nChannelProperties,
+	int16_t                           auxOutputEnable,
+	uint32_t                          autoTriggerMicroSeconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTriggerChannelConditions)
+(
+	int16_t						handle,
+	PICO_CONDITION	*	conditions,
+	int16_t						nConditions,
+	PICO_ACTION				action
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTriggerChannelDirections)
+(
+	int16_t											handle,
+	PICO_DIRECTION					*		directions,
+	int16_t											nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTriggerDelay)
+(
+	int16_t   handle,
+	uint64_t  delay
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetPulseWidthQualifierProperties)
+(
+	int16_t											handle,
+	uint32_t										lower,
+	uint32_t										upper,
+	PICO_PULSE_WIDTH_TYPE				type
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetPulseWidthQualifierConditions)
+(
+	int16_t						handle,
+	PICO_CONDITION	*	conditions,
+	int16_t						nConditions,
+	PICO_ACTION				action
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetPulseWidthQualifierDirections)
+(
+	int16_t											handle,
+	PICO_DIRECTION					*		directions,
+	int16_t											nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTriggerDigitalPortProperties)
+(
+  int16_t handle,
+  PICO_CHANNEL port,
+  PICO_DIGITAL_CHANNEL_DIRECTIONS * directions,
+  int16_t														nDirections
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetPulseWidthDigitalPortProperties)
+(
+  int16_t handle,
+  PICO_CHANNEL port,
+  PICO_DIGITAL_CHANNEL_DIRECTIONS* directions,
+  int16_t														nDirections
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetTriggerTimeOffset)
+(
+	int16_t           handle,
+	int64_t         *	time,
+	PICO_TIME_UNITS *	timeUnits,
+	uint64_t					segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValuesTriggerTimeOffsetBulk)
+(
+	int16_t             handle,
+	int64_t           *	times,
+	PICO_TIME_UNITS		*	timeUnits,
+	uint64_t						fromSegmentIndex,
+	uint64_t						toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDataBuffer)
+(
+	int16_t								handle,
+	PICO_CHANNEL					channel,
+	PICO_POINTER					buffer,
+	int32_t								nSamples,
+	PICO_DATA_TYPE				dataType,
+	uint64_t							waveform,
+	PICO_RATIO_MODE				downSampleRatioMode,
+	PICO_ACTION						action
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDataBuffers)
+(
+	int16_t           handle,
+	PICO_CHANNEL			channel,
+	PICO_POINTER			bufferMax,
+	PICO_POINTER			bufferMin,
+	int32_t						nSamples,
+	PICO_DATA_TYPE		dataType,
+	uint64_t					waveform,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	PICO_ACTION				action
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aRunBlock)
+(
+	int16_t							handle,
+	uint64_t						noOfPreTriggerSamples,
+	uint64_t						noOfPostTriggerSamples,
+	uint32_t						timebase,
+	double           *	timeIndisposedMs,
+	uint64_t						segmentIndex,
+	ps6000aBlockReady		lpReady,
+	PICO_POINTER				pParameter
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aIsReady)
+(
+	int16_t   handle,
+	int16_t * ready
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aRunStreaming)
+(
+	int16_t           handle,
+	double				*	sampleInterval,
+	PICO_TIME_UNITS		sampleIntervalTimeUnits,
+	uint64_t					maxPreTriggerSamples,
+	uint64_t					maxPostPreTriggerSamples,
+	int16_t           autoStop,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetStreamingLatestValues)
+(
+	int16_t															handle,
+	PICO_STREAMING_DATA_INFO					*	streamingDataInfo,
+	uint64_t														nStreamingDataInfos,
+	PICO_STREAMING_DATA_TRIGGER_INFO	* triggerInfo
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aNoOfStreamingValues)
+(
+	int16_t     handle,
+	uint64_t *	noOfValues
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValues)
+(
+	int16_t           handle,
+	uint64_t					startIndex,
+	uint64_t				*	noOfSamples,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	uint64_t					segmentIndex,
+	int16_t         *	overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValuesBulk)
+(
+	int16_t           handle,
+	uint64_t					startIndex,
+	uint64_t				*	noOfSamples,
+	uint64_t					fromSegmentIndex,
+	uint64_t					toSegmentIndex,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	int16_t         *	overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValuesAsync)
+(
+	int16_t           handle,
+	uint64_t					startIndex,
+	uint64_t					noOfSamples,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	uint64_t					segmentIndex,
+	PICO_POINTER			lpDataReady,
+	PICO_POINTER			pParameter
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValuesBulkAsync)
+(
+	int16_t           handle,
+	uint64_t					startIndex,
+	uint64_t					noOfSamples,
+	uint64_t					fromSegmentIndex,
+	uint64_t					toSegmentIndex,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	PICO_POINTER			lpDataReady,
+	PICO_POINTER			pParameter
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetValuesOverlapped)
+(
+	int16_t           handle,
+	uint64_t					startIndex,
+	uint64_t				*	noOfSamples,
+	uint64_t					downSampleRatio,
+	PICO_RATIO_MODE		downSampleRatioMode,
+	uint64_t					fromSegmentIndex,
+	uint64_t					toSegmentIndex,
+	int16_t         *	overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aStopUsingGetValuesOverlapped)
+(
+  int16_t           handle
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetNoOfCaptures)
+(
+	int16_t     handle,
+	uint64_t *	nCaptures
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetNoOfProcessedCaptures)
+(
+	int16_t     handle,
+	uint64_t *	nProcessedCaptures
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aStop)
+(
+	int16_t  handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetNoOfCaptures)
+(
+	int16_t   handle,
+	uint64_t  nCaptures
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetTriggerInfo)
+(
+	int16_t									handle,
+	PICO_TRIGGER_INFO			*	triggerInfo,
+	uint64_t								firstSegmentIndex,
+	uint64_t								segmentCount
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aEnumerateUnits)
+(
+	int16_t *	count,
+	int8_t  *	serials,
+	int16_t *	serialLth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aPingUnit)
+(
+	int16_t  handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetAnalogueOffsetLimits)
+(
+  int16_t                     handle,
+  PICO_CONNECT_PROBE_RANGE    range,
+  PICO_COUPLING               coupling,
+  double                      * maximumVoltage,
+  double                      * minimumVoltage
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetMinimumTimebaseStateless)
+(
+	int16_t                     handle,
+  PICO_CHANNEL_FLAGS          enabledChannelFlags,
+	uint32_t                    * timebase,
+	double                      * timeInterval,
+	PICO_DEVICE_RESOLUTION      resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aNearestSampleIntervalStateless)
+(
+	int16_t                 handle,
+  PICO_CHANNEL_FLAGS      enabledChannelFlags,
+	double		              timeIntervalRequested,
+	PICO_DEVICE_RESOLUTION  resolution,
+	uint32_t	            * timebase,
+	double		            * timeIntervalAvailable
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aChannelCombinationsStateless)
+(
+	int16_t   handle,
+	PICO_CHANNEL_FLAGS * channelFlagsCombinations,
+	uint32_t * nChannelCombinations,
+	PICO_DEVICE_RESOLUTION resolution,
+	uint32_t timebase
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDeviceResolution)
+(
+	int16_t  handle,
+	PICO_DEVICE_RESOLUTION resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetDeviceResolution)
+(
+	int16_t  handle,
+	PICO_DEVICE_RESOLUTION * resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetScalingValues)
+(
+	int16_t	handle,
+	PICO_SCALING_FACTORS_VALUES *scalingValues,
+	int16_t nChannels
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aGetAdcLimits)
+(
+	int16_t   handle,
+	PICO_DEVICE_RESOLUTION resolution,
+	int16_t * minValue,
+	int16_t * maxValue
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aCheckForUpdate)
+(
+	int16_t	handle,
+	PICO_FIRMWARE_INFO* firmwareInfos,
+	int16_t* nFirmwareInfos,
+	uint16_t* updatesRequired
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aStartFirmwareUpdate)
+(
+	int16_t	handle,
+	PicoUpdateFirmwareProgress progress
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aResetChannelsAndReportAllChannelsOvervoltageTripStatus)(
+  int16_t handle,
+  PICO_CHANNEL_OVERVOLTAGE_TRIPPED* allChannelsTrippedStatus,
+  uint8_t nChannelTrippedStatus);
+
+PREF0 PREF1 PICO_STATUS PREF2
+  PREF3(ps6000aReportAllChannelsOvervoltageTripStatus)(int16_t handle,
+                                                       PICO_CHANNEL_OVERVOLTAGE_TRIPPED* allChannelsTrippedStatus,
+                                                       uint8_t nChannelTrippedStatus);
+
+#endif

+ 116 - 0
pico-tcp-service/pico-tcp/inc/ps6000aApiExperimental.h

@@ -0,0 +1,116 @@
+/****************************************************************************
+ *
+ * Filename:    ps6000aApiExperimental.h
+ * Copyright:   Pico Technology Limited 2002 - 2022
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *  PicoScope 6000 range of PC Oscilloscopes.
+ *
+ * These functions are at the beta stage of development and their
+ * signatures may change.
+ *
+ ****************************************************************************/
+
+#ifndef __PS6000AAPIEXPERIMENTAL_H__
+#define __PS6000AAPIEXPERIMENTAL_H__
+
+
+#include "ps6000aApi.h"
+#include "PicoCallback.h"
+#include "PicoDeviceDefinitionsExperimental.h"
+
+#include <stdint.h>
+
+typedef void (PREF4 *ps6000aDigitalPortInteractions)
+(
+  int16_t    											handle,
+  PICO_STATUS											status,
+  PICO_DIGITAL_PORT_INTERACTIONS *	ports,
+  uint32_t												nPorts
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetDigitalPortInteractionCallback)
+(
+  int16_t													handle,
+  ps6000aDigitalPortInteractions	callback
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetProbeInteractionCallback)
+(
+  int16_t		handle,
+  PicoProbeInteractions callback
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetExternalReferenceInteractionCallback)
+(
+  int16_t		handle,
+  PicoExternalReferenceInteractions callback
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetAWGOverrangeInteractionCallback)
+(
+  int16_t		handle,
+  PicoAWGOverrangeInteractions callback
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetTemperatureSensorInteractionCallback)
+(
+  int16_t		handle,
+  PicoTemperatureSensorInteractions callback
+  );
+
+/// <summary>
+/// Callback signature for a probe user action notification (not to be confused with
+/// the connection / fault status change which is notified via PicoProbeInteractions).
+/// </summary>
+/// <param name="handle">The handle to the device to which the probe is attached.</param>
+/// <param name="status">
+/// Indicates if anything went wrong while handling the probe event
+/// (e.g. probe signaled an interrupt, but then communication with the probe failed).</param>
+/// <param name="channel">The channel to which the probe was attached that signaled
+/// the interrupt.
+/// </param>
+/// <param name="probe">The type of probe connected to the channel.</param>
+/// <param name="action">The probe action which the user performed.</param>
+/// <param name="pActionParameter">
+/// A pointer to a struct containing the parameters for
+/// the action, (e.g. in case of PICO_PROBE_BUTTON_PRESS, this is a
+/// PICO_PROBE_BUTTON_PRESS_PARAMETER *).
+/// </param>
+/// <param name="pParameter">A pointer to the user parameter given when setting the callback.</param>
+typedef void(PREF5* PicoProbeUserAction)(int16_t handle,
+                                         PICO_STATUS status,
+                                         PICO_CHANNEL channel,
+                                         PICO_CONNECT_PROBE probe,
+                                         PICO_PROBE_USER_ACTION action,
+                                         PICO_POINTER pActionParameter,
+                                         PICO_POINTER pParameter);
+
+/// <summary>
+/// Sets a callback for probe-specific user actions (such as button-press events).
+/// Note that ps6000aSetProbeInteractionCallback must have already been called before calling this
+/// function. Also note that like all other user callbacks (probe arrival / status, MSO arrival,
+/// temperature, external reference, AWG overrange), this callback will occur on the user interaction
+/// event loop, so it is guaranteed not to be invoked concurrently with any others. The parameter
+/// pointer will be passed back to the user via the last argument on the callback on subsequent
+/// invocations.
+/// </summary>
+/// <param name="handle">The handle to the device to which the probe is attached.</param>
+/// <param name="callback">A pointer to the callback function.</param>
+/// <param name="pParameter">A pointer to the user data.</param>
+/// <returns>
+/// A status indicating whether the callback was configured successfully. Possible errors:
+///   PICO_INVALID_HANDLE - the given handle is unknown to the driver or has been closed
+///   PICO_DRIVER_FUNCTION - a driver function has been called on another thread
+///   PICO_NOT_SUPPORTED_BY_THIS_DEVICE - the device associated with this handle does not support
+///     intelligent probes
+///   PICO_PROBE_COLLECTION_NOT_STARTED - no probe interaction callback is currently set
+/// </returns>
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps6000aSetProbeUserActionCallback) (
+  int16_t handle,
+  PicoProbeUserAction callback,
+  PICO_POINTER pParameter
+  );
+
+#endif

+ 364 - 0
pico-tcp-service/pico-tcp/inc/usbDrDaqApi.h

@@ -0,0 +1,364 @@
+/**************************************************************************
+*
+* Filename:    usbDrDaqApi.h
+* Author:      RPM & MAS
+* Description:
+*
+* This header defines the interface to driver routines for the
+* USB DrDAQ Data Logger.
+*
+* Copyright © 2010-2018 Pico Technology Ltd. All rights reserved.
+*
+*************************************************************************/
+#ifndef __USBDRDAQAPI_H__
+#define  __USBDRDAQAPI_H__
+
+#include <stdint.h>
+
+#define USB_DRDAQ_MAX_AWG_VALUE 1000
+
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+//	If you are dynamically linking usbdrdaq.dll into your project #define DYNLINK
+//  somewhere in your project before here.
+#ifdef WIN32
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (__stdcall *x)
+	#else
+		#define PREF1
+		#ifdef _USRDLL
+			#define PREF2 __declspec(dllexport) __stdcall
+		#else
+			#define PREF2 __declspec(dllimport) __stdcall
+		#endif
+		#define PREF3(x) x
+	#endif
+#else
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+	#define __stdcall
+#endif
+
+typedef enum enUsbDrDaqInputs
+{
+ 	USB_DRDAQ_CHANNEL_EXT1 = 1,				//Ext. sensor 1
+  USB_DRDAQ_CHANNEL_EXT2,						//Ext. sensor 2
+  USB_DRDAQ_CHANNEL_EXT3,						//Ext. sensor 3
+	USB_DRDAQ_CHANNEL_SCOPE,					//Scope channel
+  USB_DRDAQ_CHANNEL_PH,							//PH
+	USB_DRDAQ_CHANNEL_RES,						//Resistance
+  USB_DRDAQ_CHANNEL_LIGHT,					//Light
+	USB_DRDAQ_CHANNEL_TEMP,						//Thermistor
+  USB_DRDAQ_CHANNEL_MIC_WAVE,				//Microphone waveform
+	USB_DRDAQ_CHANNEL_MIC_LEVEL,			//Microphone level
+	USB_DRDAQ_MAX_CHANNELS = USB_DRDAQ_CHANNEL_MIC_LEVEL
+} USB_DRDAQ_INPUTS;
+
+typedef enum enUsbDrDaqScopeRange
+{
+	USB_DRDAQ_1V25,
+	USB_DRDAQ_2V5,
+	USB_DRDAQ_5V,
+	USB_DRDAQ_10V
+}USB_DRDAQ_SCOPE_RANGE;
+
+typedef enum enUsbDrDaqWave
+{
+	USB_DRDAQ_SINE,
+	USB_DRDAQ_SQUARE,
+	USB_DRDAQ_TRIANGLE,
+	USB_DRDAQ_RAMP_UP,
+	USB_DRDAQ_RAMP_DOWN,
+	USB_DRDAQ_DC
+}USB_DRDAQ_WAVE;
+
+typedef enum enUsbDrDaqDO
+{
+	USB_DRDAQ_GPIO_1 = 1,
+	USB_DRDAQ_GPIO_2,
+	USB_DRDAQ_GPIO_3,
+	USB_DRDAQ_GPIO_4
+}USB_DRDAQ_GPIO;
+
+typedef enum enUSBDrDAQInfo
+{
+  USBDrDAQ_DRIVER_VERSION,
+  USBDrDAQ_USB_VERSION,
+  USBDrDAQ_HARDWARE_VERSION,
+  USBDrDAQ_VARIANT_INFO,
+  USBDrDAQ_BATCH_AND_SERIAL,
+  USBDrDAQ_CAL_DATE,	
+  USBDrDAQ_KERNEL_DRIVER_VERSION, 
+  USBDrDAQ_ERROR,
+  USBDrDAQ_SETTINGS,
+  USBDrDAQ_FIRMWARE_VERSION,
+  USBDrDAQ_DRIVER_PATH = 14
+} USBDrDAQ_INFO;
+											
+#ifndef BM_DEFINED
+#define BM_DEFINED
+typedef enum _BLOCK_METHOD{BM_SINGLE, BM_WINDOW, BM_STREAM} BLOCK_METHOD;
+#endif
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqOpenUnit)
+(
+	int16_t *handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqCloseUnit)
+(
+	int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetUnitInfo)
+(	
+	int16_t			handle,		
+	int8_t			*string, 
+	int16_t			stringLength, 
+	int16_t			*requiredSize, 
+	PICO_INFO info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqRun) 
+(
+	int16_t						handle, 
+	uint32_t		no_of_values, 
+	BLOCK_METHOD		method
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqReady)
+(
+	int16_t handle, 
+	int16_t *ready
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqStop) 
+(
+	int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetInterval)
+(	
+	int16_t							handle,
+	uint32_t			*us_for_block,
+	uint32_t			ideal_no_of_samples,
+	USB_DRDAQ_INPUTS	*channels,
+	int16_t							no_of_channels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetIntervalF)
+(	
+	int16_t							handle,
+	float						*	us_for_block,
+	uint32_t			ideal_no_of_samples,
+	USB_DRDAQ_INPUTS	*channels,
+	int16_t							no_of_channels
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetTrigger)
+(
+	int16_t						handle,
+	uint16_t	enabled,
+	uint16_t	auto_trigger,
+	uint16_t	auto_ms,
+	uint16_t	channel,
+	uint16_t	dir,
+	int16_t						threshold,
+	uint16_t	hysterisis,
+	float						delay
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetValues) 
+(
+	int16_t						handle,
+	int16_t						*values,
+	uint32_t		*noOfValues, 
+	uint16_t	*overflow,
+	uint32_t		*triggerIndex
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetValuesF) 
+	(
+	int16_t						handle,
+	float						*values,
+	uint32_t		*noOfValues, 
+	uint16_t	*overflow,
+	uint32_t		*triggerIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetTriggerTimeOffsetNs)	
+(
+	int16_t		handle, 
+	int64_t *time
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetSingle) 
+(
+	int16_t							handle, 
+	USB_DRDAQ_INPUTS	channel, 
+	int16_t							*value, 
+	uint16_t		*overflow
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetSingleF) 
+	(
+	int16_t							handle, 
+	USB_DRDAQ_INPUTS	channel, 
+	float							*value, 
+	uint16_t		*overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqOpenUnitAsync) 
+(
+	int16_t *status
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqOpenUnitProgress) 
+(
+	int16_t *handle, 
+	int16_t *progress, 
+	int16_t *complete
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetScalings)
+(
+	int16_t							handle, 
+	USB_DRDAQ_INPUTS	channel, 
+	int16_t							*nScales, 
+	int16_t							*currentScale, 
+	int8_t							*names, 
+	int16_t							namesSize
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetScalings)
+(
+	int16_t							handle, 
+	USB_DRDAQ_INPUTS	channel, 
+	int16_t							scalingNumber
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetSigGenBuiltIn)
+(
+	int16_t						handle, 
+	int32_t						offsetVoltage,
+	uint32_t		pkToPk,
+	int16_t						frequency,
+	USB_DRDAQ_WAVE	waveType
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetSigGenArbitrary)
+(
+	int16_t					handle, 
+	int32_t					offsetVoltage,
+	uint32_t	pkToPk,
+	int16_t					*arbitraryWaveform,
+	int16_t					arbitraryWaveformSize,
+	int32_t					updateRate
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqStopSigGen)
+(
+	int16_t	handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetDO)
+(
+	int16_t						handle,
+	USB_DRDAQ_GPIO	IOChannel,
+	int16_t						value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetPWM)
+(
+	int16_t						handle,
+	USB_DRDAQ_GPIO	IOChannel,
+	uint16_t	period,
+	uint8_t		cycle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetInput)
+(
+	int16_t						handle,
+	USB_DRDAQ_GPIO	IOChannel,
+	int16_t						pullUp,
+	int16_t						*value
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqStartPulseCount)
+(
+	int16_t						handle,
+	USB_DRDAQ_GPIO	IOChannel,
+	int16_t						direction
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetPulseCount)
+(
+	int16_t						handle,
+	USB_DRDAQ_GPIO	IOChannel,
+	int16_t						*count
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqEnableRGBLED)
+(
+	int16_t	handle,
+	int16_t enabled
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqSetRGBLED)
+(
+	int16_t	handle,
+	uint16_t	red,
+	uint16_t	green,
+	uint16_t	blue
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbDrDaqGetChannelInfo)
+(
+	int16_t							handle,
+	float							*min,
+	float							*max,
+	int16_t							*places,
+	int16_t 						*divider,
+	USB_DRDAQ_INPUTS	channel
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbDrDaqPingUnit) (int16_t handle);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(UsbDrDaqPhTemperatureCompensation)
+(
+	int16_t	handle,
+	uint16_t enabled
+	);
+#endif

+ 181 - 0
pico-tcp-service/pico-tcp/inc/usbPT104Api.h

@@ -0,0 +1,181 @@
+/**************************************************************************
+*
+* Filename:    usbPT104Api.h
+* Author:      MAS
+* Description:
+*
+* This header defines the interface to driver routines for the
+* USB PT-104 Platinum Resistance Temperature Data Logger.
+*
+* Copyright � 2009 - 2022 Pico Technology Ltd. All rights reserved.
+*
+*************************************************************************/
+#ifndef __USBPT104API_H__
+#define __USBPT104API_H__
+
+#include <stdint.h>
+#include "PicoStatus.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+  //	If you are dynamically linking usbpt104.DLL into your project #define DYNLINK
+  //  somewhere in your project before here.
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec(dllexport) __stdcall
+    #else
+      #define PREF2 __declspec(dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+#else
+  /* Define a 64-bit integer type */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+#endif
+
+#define USBPT104_MIN_WIRES 2
+#define USBPT104_MAX_WIRES 4
+
+typedef enum enUsbPt104Channels
+{
+  USBPT104_CHANNEL_1 = 1,
+  USBPT104_CHANNEL_2,
+  USBPT104_CHANNEL_3,
+  USBPT104_CHANNEL_4,
+  USBPT104_CHANNEL_5,
+  USBPT104_CHANNEL_6,
+  USBPT104_CHANNEL_7,
+  USBPT104_CHANNEL_8,
+	USBPT104_MAX_CHANNELS = USBPT104_CHANNEL_8
+} USBPT104_CHANNELS;
+
+
+typedef enum enUsbPt104DataType
+{
+  USBPT104_OFF,
+  USBPT104_PT100,
+  USBPT104_PT1000,
+  USBPT104_RESISTANCE_TO_375R,
+  USBPT104_RESISTANCE_TO_10K,
+  USBPT104_DIFFERENTIAL_TO_115MV,
+  USBPT104_DIFFERENTIAL_TO_2500MV,
+  USBPT104_SINGLE_ENDED_TO_115MV,
+  USBPT104_SINGLE_ENDED_TO_2500MV,
+  USBPT104_MAX_DATA_TYPES
+} USBPT104_DATA_TYPES;
+
+typedef enum enIpDetailsType
+{
+  IDT_GET,
+  IDT_SET,
+} IP_DETAILS_TYPE;
+
+typedef enum enCommunicationType
+{
+  CT_USB = 0x00000001,
+  CT_ETHERNET = 0x00000002,
+  CT_ALL = 0xFFFFFFFF
+}COMMUNICATION_TYPE;
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbPt104Enumerate)
+(
+  int8_t   *details,
+  uint32_t *length,
+  COMMUNICATION_TYPE type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104OpenUnit)
+(
+  int16_t *handle,
+  int8_t  *serial
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbPt104OpenUnitViaIp)
+(
+  int16_t *handle,
+  int8_t  *serial,
+  int8_t  *ipAddress
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104CloseUnit)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (UsbPt104IpDetails)
+(
+  int16_t   handle,
+  int16_t  *enabled,
+  int8_t   *ipaddress,
+  uint16_t *length,
+  uint16_t *listeningPort,
+  IP_DETAILS_TYPE type
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104GetUnitInfo)
+(
+  int16_t    handle,
+  int8_t    *string,
+  int16_t    stringLength,
+  int16_t   *requiredSize,
+  PICO_INFO  info
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104SetChannel)
+(
+  int16_t              handle,
+  USBPT104_CHANNELS    channel,
+  USBPT104_DATA_TYPES  type,
+  int16_t              noOfWires
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104SetMains)
+(
+  int16_t  handle,
+  uint16_t sixtyHertz
+);
+
+PREF0 PREF1 PICO_STATUS PREF2  PREF3 (UsbPt104GetValue)
+(
+  int16_t            handle,
+  USBPT104_CHANNELS  channel,
+  int32_t           *value,
+  int16_t            filtered
+);
+
+#endif

+ 387 - 0
pico-tcp-service/pico-tcp/inc/usbtc08.h

@@ -0,0 +1,387 @@
+/*********************************************************************
+ *
+ * Filename:    usbtc08.h
+ * Author:      SDI & MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ * USB TC-08 Thermocouple Data Loggers.
+ *
+ * History:	12May03 SDI Created
+ *
+ * Copyright � 2002 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ *********************************************************************/
+#ifndef __USBTC08_H__
+#define __USBTC08_H__
+
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+  #define PREF0 extern "C"
+#else
+  #define PREF0
+#endif
+
+#ifdef WIN32
+  #ifdef PREF1
+    #undef PREF1
+  #endif
+  #ifdef PREF2
+    #undef PREF2
+  #endif
+  #ifdef PREF3
+    #undef PREF3
+  #endif
+  /*	If you are dynamically linking usbtc08.dll into your project #define DYNLINK here
+  */
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (__stdcall *x)
+  #else
+    #define PREF1
+    #ifdef _USRDLL
+      #define PREF2 __declspec (dllexport) __stdcall
+    #else
+      #define PREF2 __declspec (dllimport) __stdcall
+    #endif
+    #define PREF3(x) x
+  #endif
+#else
+  #ifdef DYNLINK
+    #define PREF1 typedef
+    #define PREF2
+    #define PREF3(x) (*x)
+  #else
+    #ifdef _USRDLL
+      #define PREF1 __attribute__((visibility("default")))
+    #else
+      #define PREF1
+    #endif
+    #define PREF2
+    #define PREF3(x) x
+  #endif
+  #define __stdcall
+#endif
+
+
+/* General Defines **************************************************/
+#define USBTC08_MAX_FILTER_SIZE   255
+#define USBTC08_MAX_SAMPLE_BUFFER 600 /* Max readings that usb_tc08_get_temp will ever return */
+#define USBTC08_MAX_INFO_CHARS    256
+#define USBTC08_MAX_DATE_CHARS    9
+#define USBTC08_MAX_SERIAL_CHARS  11
+#define USBTC08_MAX_VERSION_CHARS 12
+#define USBTC08_MAX_VERSION_CHARS_V2 25
+
+/* Enumerations *****************************************************/
+
+/* There are 8 channels from 1 to 8
+ *  to enumerate them, use:
+ *
+ *  for (i = 1; i <= USBTC08_MAX_CHANNELS; i++)
+ *
+ *  the Cold Junction Compensation is channel 0
+ */
+typedef enum enUSBTC08Channels
+{
+  USBTC08_CHANNEL_CJC,
+  USBTC08_CHANNEL_1,
+  USBTC08_CHANNEL_2,
+  USBTC08_CHANNEL_3,
+  USBTC08_CHANNEL_4,
+  USBTC08_CHANNEL_5,
+  USBTC08_CHANNEL_6,
+  USBTC08_CHANNEL_7,
+  USBTC08_CHANNEL_8,
+  USBTC08_MAX_CHANNELS = USBTC08_CHANNEL_8
+} USBTC08_CHANNELS;
+
+typedef enum enUSBTC08Progress
+{
+  USBTC08_PROGRESS_FAIL     = -1,
+  USBTC08_PROGRESS_PENDING  = 0,
+  USBTC08_PROGRESS_COMPLETE = 1
+} USBTC08_PROGRESS;
+
+typedef enum enUSBTC08Error
+{
+  /*========================
+  User/Developer error codes
+  =========================*/
+  USBTC08_ERROR_OK,
+  USBTC08_ERROR_OS_NOT_SUPPORTED,	      /* need to use win98 (or later) or win2k (or later) */
+  USBTC08_ERROR_NO_CHANNELS_SET,
+  USBTC08_ERROR_INVALID_PARAMETER,      /* one or more of the function arguments was invalid */
+  USBTC08_ERROR_VARIANT_NOT_SUPPORTED,  /* the hardware version is not supported (download the latest driver) */
+  USBTC08_ERROR_INCORRECT_MODE,         /* an incompatible mix of legacy and non-legacy functions was called
+                                           ... or usb_tc08_get_single was called while streaming was active */
+  USBTC08_ERROR_ENUMERATION_INCOMPLETE, /* a second call to usb_tc08_open_unit_async() was made before
+                                           asynchronous enumeration had completed */
+
+  /*=======================
+  Reserved Pico error codes
+  ========================*/
+  USBTC08_ERROR_NOT_RESPONDING,         /* unit is not responding to the driver */
+  USBTC08_ERROR_FW_FAIL,                /* unabled to download firmware */
+  USBTC08_ERROR_CONFIG_FAIL,		        /* missing or corrupted eeprom */
+  USBTC08_ERROR_NOT_FOUND,			        /* cannot find enumerated device */
+  USBTC08_ERROR_THREAD_FAIL,            /* a threading function failed */
+  USBTC08_ERROR_PIPE_INFO_FAIL,         /* could not get pipes from the device */
+  USBTC08_ERROR_NOT_CALIBRATED,          /* no calibration date was found */
+  USBTC08_EROOR_PICOPP_TOO_OLD,
+	USBTC08_ERROR_PICOPP_TOO_OLD = USBTC08_EROOR_PICOPP_TOO_OLD,
+	USBTC08_ERROR_PICO_DRIVER_FUNCTION,
+
+  /*===========================
+  New User/Developererror codes
+  ============================*/
+  USBTC08_ERROR_COMMUNICATION           /*the PC has lost communication with unit*/
+}	USBTC08_ERROR;
+
+typedef enum enUSBTC08Units
+{
+  USBTC08_UNITS_CENTIGRADE,
+  USBTC08_UNITS_FAHRENHEIT,
+  USBTC08_UNITS_KELVIN,
+  USBTC08_UNITS_RANKINE,
+  USBTC08_MAX_UNITS = USBTC08_UNITS_RANKINE
+} USBTC08_UNITS;
+
+typedef enum enUSBTC08InfoLine
+{
+  USBTC08LINE_DRIVER_VERSION,
+  USBTC08LINE_KERNEL_DRIVER_VERSION,
+  USBTC08LINE_HARDWARE_VERSION,
+  USBTC08LINE_VARIANT_INFO,
+  USBTC08LINE_BATCH_AND_SERIAL,
+  USBTC08LINE_CAL_DATE,
+  USBTC08LINE_DRIVER_PATH
+} USBTC08_INFO_LINE;
+
+/* Structures *****************************************************/
+
+typedef struct tUSBTC08Info
+{
+  int16_t size;
+  int8_t  DriverVersion[USBTC08_MAX_VERSION_CHARS];
+  int16_t PicoppVersion;
+  int16_t HardwareVersion;
+  int16_t Variant;
+  int8_t  szSerial[USBTC08_MAX_SERIAL_CHARS];
+  int8_t  szCalDate[USBTC08_MAX_DATE_CHARS];
+} USBTC08_INFO, *LPUSBTC08_INFO;
+
+typedef struct tUSBTC08InfoV2
+{
+  int16_t size;
+  int8_t DriverVersion[USBTC08_MAX_VERSION_CHARS_V2];
+  int16_t UsbVersion;
+  int16_t HardwareVersion;
+  int16_t Variant;
+  int8_t szSerial[USBTC08_MAX_SERIAL_CHARS];
+  int8_t szCalDate[USBTC08_MAX_DATE_CHARS];
+} USBTC08_INFO_V2, *LPUSBTC08_INFO_V2;
+
+/*====================================================================
+    New USB TC08 API Calls
+
+    This set of functions should be used in preference to the
+    Legacy API calls at the bottom of this header file
+    (see also 'Shared API Calls' which are designed to be used
+    with the new API calls, but can also be used with legacy calls)
+=====================================================================*/
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_set_channel)
+(
+  int16_t handle,
+  int16_t channel,
+  int8_t  tc_type
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(usb_tc08_run)
+(
+  int16_t handle,
+  int32_t interval_ms
+);
+
+/* must be called at least once per minute to ensure no data is lost */
+PREF0 PREF1 int32_t PREF2 PREF3(usb_tc08_get_temp)
+(
+  int16_t  handle,
+  float   *temp_buffer,
+  int32_t *times_ms_buffer, /* wraps back to zero after 24 days */
+  int32_t  buffer_length,
+  int16_t *overflow,
+  int16_t  channel,
+  int16_t  units,
+  int16_t  fill_missing
+);
+
+PREF0 PREF1 int32_t PREF2 PREF3(usb_tc08_get_temp_deskew)
+(
+  int16_t  handle,
+  float   *temp_buffer,
+  int32_t *times_ms_buffer, /* wraps back to zero after 24 days */
+  int32_t  buffer_length,
+  int16_t *overflow,
+  int16_t  channel,
+  int16_t  units,
+  int16_t  fill_missing
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_single)
+(
+  int16_t  handle,
+  float   *temp,
+  int16_t *overflow_flags,
+  int16_t  units
+);
+
+/*==========================================================================
+    Shared API Calls
+
+    These functions are designed for use with the USB TC08,
+    however, they can (and should) still be used with the legacy API calls
+===========================================================================*/
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_open_unit)
+(
+  void
+);
+
+/* These two functions are used instead of usb_tc08_open_unit()
+ * if the calling application needs to perform operations while
+ * waiting for a unit to open
+ */
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_open_unit_async)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_open_unit_progress)
+(
+  int16_t *handle,
+  int16_t *percent_progress
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_close_unit)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_stop)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_set_mains)
+(
+  int16_t handle,
+  int16_t sixty_hertz
+);
+
+/* set-up all channels before calling this
+ * in legacy mode, this will be the fixed sampling rate
+ */
+PREF0 PREF1 int32_t PREF2 PREF3(usb_tc08_get_minimum_interval_ms)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_unit_info)
+(
+  int16_t handle, USBTC08_INFO * info
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_unit_info_v2)
+(
+  int16_t handle, USBTC08_INFO_V2* info
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_unit_info2)
+(
+  int16_t  handle,
+  int8_t  *string,
+  int16_t  string_length,
+  int16_t  line
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_formatted_info)
+(
+  int16_t  handle,
+  int8_t  *unit_info,
+  int16_t  string_length);
+
+/* pass 0 as the unit handle to get the last reason
+ * that usb_tc08_open_unit() failed
+ */
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_get_last_error)
+(
+  int16_t handle
+);
+
+/*====================================================================
+    Legacy API Calls
+
+    Provided to aid backwards compatibility with code written
+    for old TC08 Units (differences exist).
+
+    These functions should not be used in new code and are
+    deprecated for removal in a future version of the driver.
+=====================================================================*/
+
+/* Legacy defines
+ */
+#define CHANNELS_PER_TC08 8
+#define MAX_TC08_UNITS    64
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_run)
+(
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_set_channel)
+(
+  int16_t handle,
+  int16_t channel,
+  int8_t  tc_type,
+  int16_t filter_factor,
+  int16_t offset,
+  int16_t slope
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_get_temp)
+(
+  int32_t  *temp,
+  int16_t   handle,
+  uint16_t  channel,
+  uint16_t  filtered
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_get_cold_junction)
+(
+  int32_t * temp,
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_get_driver_version)
+(
+  void
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_get_version)
+(
+  int16_t *version,
+  int16_t handle
+);
+
+PREF0 PREF1 int16_t PREF2 PREF3(usb_tc08_legacy_get_cycle)
+(
+  int32_t *cycle,
+  int16_t handle
+);
+
+#endif

+ 1316 - 0
pico-tcp-service/pico-tcp/libps4000a/PicoStatus.h

@@ -0,0 +1,1316 @@
+/**************************************************************************
+*
+* Filename:    PicoStatus.h
+* Copyright:   Pico Technology Limited 2002 - 2022
+* Description:
+*
+* This header files defines the status codes returned by a
+*	Pico device, a PC Oscilloscope or Data Logger.
+*
+* In comments, "<API>" is a placeholder for the name of the scope or
+* data logger API. For example, for the ps5000a API, it stands for
+* "PS5000A" or "ps5000a".
+*
+*************************************************************************/
+#ifndef __PICOSTATUS_H__
+#define __PICOSTATUS_H__
+
+#include <stdint.h>
+
+typedef void * PICO_POINTER;
+
+#define	PICO_DRIVER_VERSION                         0x00000000UL
+#define	PICO_USB_VERSION                            0x00000001UL
+#define	PICO_HARDWARE_VERSION                       0x00000002UL
+#define	PICO_VARIANT_INFO                           0x00000003UL
+#define	PICO_BATCH_AND_SERIAL                       0x00000004UL
+#define	PICO_CAL_DATE                               0x00000005UL
+#define	PICO_KERNEL_VERSION                         0x00000006UL
+
+#define PICO_DIGITAL_HARDWARE_VERSION               0x00000007UL
+#define PICO_ANALOGUE_HARDWARE_VERSION              0x00000008UL
+
+#define PICO_FIRMWARE_VERSION_1                     0x00000009UL
+#define PICO_FIRMWARE_VERSION_2                     0x0000000AUL
+
+#define PICO_MAC_ADDRESS                            0x0000000BUL
+
+#define PICO_SHADOW_CAL                             0x0000000CUL
+
+#define PICO_IPP_VERSION                            0x0000000DUL
+
+#define PICO_DRIVER_PATH                            0x0000000EUL
+
+#define PICO_FIRMWARE_VERSION_3                     0x0000000FUL
+
+#define PICO_FRONT_PANEL_FIRMWARE_VERSION           0x00000010UL
+
+#define PICO_BOOTLOADER_VERSION						0x10000001UL
+
+typedef uint32_t PICO_INFO;
+
+// The PicoScope is functioning correctly.
+#define PICO_OK                                     0x00000000UL
+
+// An attempt has been made to open more than <API>_MAX_UNITS.
+#define PICO_MAX_UNITS_OPENED                       0x00000001UL
+
+// Not enough memory could be allocated on the host machine.
+#define PICO_MEMORY_FAIL                            0x00000002UL
+
+// No Pico Technology device could be found.
+#define PICO_NOT_FOUND                              0x00000003UL
+
+// Unable to download firmware.
+#define PICO_FW_FAIL                                0x00000004UL
+
+// The driver is busy opening a device.
+#define PICO_OPEN_OPERATION_IN_PROGRESS             0x00000005UL
+
+// An unspecified failure occurred.
+#define PICO_OPERATION_FAILED                       0x00000006UL
+
+// The PicoScope is not responding to commands from the PC.
+#define PICO_NOT_RESPONDING                         0x00000007UL
+
+// The configuration information in the PicoScope is corrupt or missing.
+#define PICO_CONFIG_FAIL                            0x00000008UL
+
+// The picopp.sys file is too old to be used with the device driver.
+#define PICO_KERNEL_DRIVER_TOO_OLD                  0x00000009UL
+
+// The EEPROM has become corrupt, so the device will use a default setting.
+#define PICO_EEPROM_CORRUPT                         0x0000000AUL
+
+// The operating system on the PC is not supported by this driver.
+#define PICO_OS_NOT_SUPPORTED                       0x0000000BUL
+
+// There is no device with the handle value passed.
+#define PICO_INVALID_HANDLE                         0x0000000CUL
+
+// A parameter value is not valid.
+#define PICO_INVALID_PARAMETER                      0x0000000DUL
+
+// The timebase is not supported or is invalid.
+#define PICO_INVALID_TIMEBASE                       0x0000000EUL
+
+// The voltage range is not supported or is invalid.
+#define PICO_INVALID_VOLTAGE_RANGE                  0x0000000FUL
+
+// The channel number is not valid on this device or no channels have been set.
+#define PICO_INVALID_CHANNEL                        0x00000010UL
+
+// The channel set for a trigger is not available on this device.
+#define PICO_INVALID_TRIGGER_CHANNEL                0x00000011UL
+
+// The channel set for a condition is not available on this device.
+#define PICO_INVALID_CONDITION_CHANNEL              0x00000012UL
+
+// The device does not have a signal generator.
+#define PICO_NO_SIGNAL_GENERATOR                    0x00000013UL
+
+// Streaming has failed to start or has stopped without user request.
+#define PICO_STREAMING_FAILED                       0x00000014UL
+
+// Block failed to start - a parameter may have been set wrongly.
+#define PICO_BLOCK_MODE_FAILED                      0x00000015UL
+
+// A parameter that was required is NULL.
+#define PICO_NULL_PARAMETER                         0x00000016UL
+
+// The current functionality is not available while using ETS capture mode.
+#define PICO_ETS_MODE_SET                           0x00000017UL
+
+// No data is available from a run block call.
+#define PICO_DATA_NOT_AVAILABLE                     0x00000018UL
+
+// The buffer passed for the information was too small.
+#define PICO_STRING_BUFFER_TO_SMALL                 0x00000019UL
+
+// ETS is not supported on this device.
+#define PICO_ETS_NOT_SUPPORTED                      0x0000001AUL
+
+// The auto trigger time is less than the time it will take to collect the pre-trigger data.
+#define PICO_AUTO_TRIGGER_TIME_TO_SHORT             0x0000001BUL
+
+// The collection of data has stalled as unread data would be overwritten.
+#define PICO_BUFFER_STALL                           0x0000001CUL
+
+// Number of samples requested is more than available in the current memory segment.
+#define PICO_TOO_MANY_SAMPLES                       0x0000001DUL
+
+// Not possible to create number of segments requested.
+#define PICO_TOO_MANY_SEGMENTS                      0x0000001EUL
+
+// A null pointer has been passed in the trigger function or one of the parameters is out of range.
+#define PICO_PULSE_WIDTH_QUALIFIER                  0x0000001FUL
+
+// One or more of the hold-off parameters are out of range.
+#define PICO_DELAY                                  0x00000020UL
+
+// One or more of the source details are incorrect.
+#define	PICO_SOURCE_DETAILS                         0x00000021UL
+
+// One or more of the conditions are incorrect.
+#define PICO_CONDITIONS                             0x00000022UL
+
+// The driver's thread is currently in the <API>Ready callback
+// function and therefore the action cannot be carried out.
+#define	PICO_USER_CALLBACK                          0x00000023UL
+
+// An attempt is being made to get stored data while streaming.
+// Either stop streaming by calling <API>Stop, or use <API>GetStreamingLatestValues.
+#define PICO_DEVICE_SAMPLING                        0x00000024UL
+
+// Data is unavailable because a run has not been completed.
+#define PICO_NO_SAMPLES_AVAILABLE                   0x00000025UL
+
+// The memory segment index is out of range.
+#define PICO_SEGMENT_OUT_OF_RANGE                   0x00000026UL
+
+// The device is busy so data cannot be returned yet.
+#define PICO_BUSY                                   0x00000027UL
+
+// The start time to get stored data is out of range.
+#define PICO_STARTINDEX_INVALID                     0x00000028UL
+
+// The information number requested is not a valid number.
+#define PICO_INVALID_INFO                           0x00000029UL
+
+// The handle is invalid so no information is available about the device.
+// Only PICO_DRIVER_VERSION is available.
+#define PICO_INFO_UNAVAILABLE                       0x0000002AUL
+
+// The sample interval selected for streaming is out of range.
+#define PICO_INVALID_SAMPLE_INTERVAL                0x0000002BUL
+
+// ETS is set but no trigger has been set. A trigger setting is required for ETS.
+#define PICO_TRIGGER_ERROR                          0x0000002CUL
+
+// Driver cannot allocate memory.
+#define PICO_MEMORY                                 0x0000002DUL
+
+// Incorrect parameter passed to the signal generator.
+#define PICO_SIG_GEN_PARAM                          0x0000002EUL
+
+// Conflict between the shots and sweeps parameters sent to the signal generator.
+#define PICO_SHOTS_SWEEPS_WARNING                   0x0000002FUL
+
+// A software trigger has been sent but the trigger source is not a software trigger.
+#define PICO_SIGGEN_TRIGGER_SOURCE                  0x00000030UL
+
+// An <API>SetTrigger call has found a conflict between the trigger source and the AUX output enable.
+#define PICO_AUX_OUTPUT_CONFLICT                    0x00000031UL
+
+// ETS mode is being used and AUX is set as an input.
+#define PICO_AUX_OUTPUT_ETS_CONFLICT                0x00000032UL
+
+// Attempt to set different EXT input thresholds set for signal generator and oscilloscope trigger.
+#define PICO_WARNING_EXT_THRESHOLD_CONFLICT         0x00000033UL
+
+// An <API>SetTrigger... function has set AUX as an output and the signal generator is using it as a trigger.
+#define PICO_WARNING_AUX_OUTPUT_CONFLICT            0x00000034UL
+
+// The combined peak-to-peak voltage and the analog offset voltage exceed the maximum voltage the signal generator can produce.
+#define PICO_SIGGEN_OUTPUT_OVER_VOLTAGE             0x00000035UL
+
+// NULL pointer passed as delay parameter.
+#define PICO_DELAY_NULL                             0x00000036UL
+
+// The buffers for overview data have not been set while streaming.
+#define PICO_INVALID_BUFFER                         0x00000037UL
+
+// The analog offset voltage is out of range.
+#define PICO_SIGGEN_OFFSET_VOLTAGE                  0x00000038UL
+
+// The analog peak-to-peak voltage is out of range.
+#define PICO_SIGGEN_PK_TO_PK                        0x00000039UL
+
+// A block collection has been cancelled.
+#define PICO_CANCELLED                              0x0000003AUL
+
+// The segment index is not currently being used.
+#define PICO_SEGMENT_NOT_USED                       0x0000003BUL
+
+// The wrong GetValues function has been called for the collection mode in use.
+#define PICO_INVALID_CALL                           0x0000003CUL
+
+#define PICO_GET_VALUES_INTERRUPTED                 0x0000003DUL
+
+// The function is not available.
+#define PICO_NOT_USED                               0x0000003FUL
+
+// The aggregation ratio requested is out of range.
+#define PICO_INVALID_SAMPLERATIO                    0x00000040UL
+
+// Device is in an invalid state.
+#define PICO_INVALID_STATE                          0x00000041UL
+
+// The number of segments allocated is fewer than the number of captures requested.
+#define PICO_NOT_ENOUGH_SEGMENTS                    0x00000042UL
+
+// A driver function has already been called and not yet finished.
+// Only one call to the driver can be made at any one time.
+#define PICO_DRIVER_FUNCTION                        0x00000043UL
+
+// Not used.
+#define PICO_RESERVED                               0x00000044UL
+
+// An invalid coupling type was specified in <API>SetChannel.
+#define PICO_INVALID_COUPLING                       0x00000045UL
+
+// An attempt was made to get data before a data buffer was defined.
+#define PICO_BUFFERS_NOT_SET                        0x00000046UL
+
+// The selected downsampling mode (used for data reduction) is not allowed.
+#define PICO_RATIO_MODE_NOT_SUPPORTED               0x00000047UL
+
+// Aggregation was requested in rapid block mode.
+#define PICO_RAPID_NOT_SUPPORT_AGGREGATION          0x00000048UL
+
+// An invalid parameter was passed to <API>SetTriggerChannelProperties(V2).
+#define PICO_INVALID_TRIGGER_PROPERTY               0x00000049UL
+
+// The driver was unable to contact the oscilloscope.
+#define PICO_INTERFACE_NOT_CONNECTED                0x0000004AUL
+
+// Resistance-measuring mode is not allowed in conjunction with the specified probe.
+#define PICO_RESISTANCE_AND_PROBE_NOT_ALLOWED       0x0000004BUL
+
+// The device was unexpectedly powered down.
+#define PICO_POWER_FAILED                           0x0000004CUL
+
+// A problem occurred in <API>SetSigGenBuiltIn or <API>SetSigGenArbitrary.
+#define PICO_SIGGEN_WAVEFORM_SETUP_FAILED           0x0000004DUL
+
+// FPGA not successfully set up.
+#define PICO_FPGA_FAIL                              0x0000004EUL
+
+#define PICO_POWER_MANAGER                          0x0000004FUL
+
+// An impossible analog offset value was specified in <API>SetChannel.
+#define PICO_INVALID_ANALOGUE_OFFSET                0x00000050UL
+
+// There is an error within the device hardware.
+#define PICO_PLL_LOCK_FAILED                        0x00000051UL
+
+// There is an error within the device hardware.
+#define PICO_ANALOG_BOARD                           0x00000052UL
+
+// Unable to configure the signal generator.
+#define PICO_CONFIG_FAIL_AWG                        0x00000053UL
+
+// The FPGA cannot be initialized, so unit cannot be opened.
+#define PICO_INITIALISE_FPGA                        0x00000054UL
+
+// The frequency for the external clock is not within 15% of the nominal value.
+#define PICO_EXTERNAL_FREQUENCY_INVALID             0x00000056UL
+
+// The FPGA could not lock the clock signal.
+#define PICO_CLOCK_CHANGE_ERROR                     0x00000057UL
+
+// You are trying to configure the AUX input as both a trigger and a reference clock.
+#define PICO_TRIGGER_AND_EXTERNAL_CLOCK_CLASH       0x00000058UL
+
+// You are trying to configure the AUX input as both a pulse width qualifier and a reference clock.
+#define PICO_PWQ_AND_EXTERNAL_CLOCK_CLASH           0x00000059UL
+
+// The requested scaling file cannot be opened.
+#define PICO_UNABLE_TO_OPEN_SCALING_FILE            0x0000005AUL
+
+// The frequency of the memory is reporting incorrectly.
+#define PICO_MEMORY_CLOCK_FREQUENCY                 0x0000005BUL
+
+// The I2C that is being actioned is not responding to requests.
+#define PICO_I2C_NOT_RESPONDING                     0x0000005CUL
+
+// There are no captures available and therefore no data can be returned.
+#define PICO_NO_CAPTURES_AVAILABLE                  0x0000005DUL
+
+// The number of trigger channels is greater than 4,
+// except for a PicoScope 4824 where 8 channels are allowed for rising/falling/rising_or_falling trigger directions.
+#define PICO_TOO_MANY_TRIGGER_CHANNELS_IN_USE				0x0000005FUL
+
+// If you have specified a trigger direction which is not allowed, for example specifying PICO_ABOVE
+// without another condition which crosses a threshold on another channel.
+#define PICO_INVALID_TRIGGER_DIRECTION							0x00000060UL
+
+// When more than 4 trigger channels are set and their trigger condition states are not <API>_CONDITION_TRUE.
+#define PICO_INVALID_TRIGGER_STATES									0x00000061UL
+
+// The capture mode the device is currently running in does not support the current request.
+#define PICO_NOT_USED_IN_THIS_CAPTURE_MODE          0x0000005EUL
+
+#define PICO_GET_DATA_ACTIVE                        0x00000103UL
+
+// Codes 104 to 10B are used by the PT104 (USB) when connected via the Network Socket.
+
+// The device is currently connected via the IP Network socket and thus the call made is not supported.
+#define PICO_IP_NETWORKED                           0x00000104UL
+
+// An incorrect IP address has been passed to the driver.
+#define PICO_INVALID_IP_ADDRESS                     0x00000105UL
+
+// The IP socket has failed.
+#define PICO_IPSOCKET_FAILED                        0x00000106UL
+
+// The IP socket has timed out.
+#define PICO_IPSOCKET_TIMEDOUT                      0x00000107UL
+
+// Failed to apply the requested settings.
+#define PICO_SETTINGS_FAILED                        0x00000108UL
+
+// The network connection has failed.
+#define PICO_NETWORK_FAILED                         0x00000109UL
+
+// Unable to load the WS2 DLL.
+#define PICO_WS2_32_DLL_NOT_LOADED                  0x0000010AUL
+
+// The specified IP port is invalid.
+#define PICO_INVALID_IP_PORT                        0x0000010BUL
+
+// The type of coupling requested is not supported on the opened device.
+#define PICO_COUPLING_NOT_SUPPORTED                 0x0000010CUL
+
+// Bandwidth limiting is not supported on the opened device.
+#define PICO_BANDWIDTH_NOT_SUPPORTED                0x0000010DUL
+
+// The value requested for the bandwidth limit is out of range.
+#define PICO_INVALID_BANDWIDTH                      0x0000010EUL
+
+// The arbitrary waveform generator is not supported by the opened device.
+#define PICO_AWG_NOT_SUPPORTED                      0x0000010FUL
+
+// Data has been requested with ETS mode set but run block has not been called,
+// or stop has been called.
+#define PICO_ETS_NOT_RUNNING                        0x00000110UL
+
+// White noise output is not supported on the opened device.
+#define PICO_SIG_GEN_WHITENOISE_NOT_SUPPORTED       0x00000111UL
+
+// The wave type requested is not supported by the opened device.
+#define PICO_SIG_GEN_WAVETYPE_NOT_SUPPORTED         0x00000112UL
+
+// The requested digital port number is out of range (MSOs only).
+#define PICO_INVALID_DIGITAL_PORT                   0x00000113UL
+
+// The digital channel is not in the range <API>_DIGITAL_CHANNEL0 to
+// <API>_DIGITAL_CHANNEL15, the digital channels that are supported.
+#define PICO_INVALID_DIGITAL_CHANNEL                0x00000114UL
+
+// The digital trigger direction is not a valid trigger direction and should be equal
+// in value to one of the <API>_DIGITAL_DIRECTION enumerations.
+#define PICO_INVALID_DIGITAL_TRIGGER_DIRECTION      0x00000115UL
+
+// Signal generator does not generate pseudo-random binary sequence.
+#define	PICO_SIG_GEN_PRBS_NOT_SUPPORTED             0x00000116UL
+
+// When a digital port is enabled, ETS sample mode is not available for use.
+#define PICO_ETS_NOT_AVAILABLE_WITH_LOGIC_CHANNELS  0x00000117UL
+
+// There has been no new sample taken, this value has already been returned previously.
+#define PICO_WARNING_REPEAT_VALUE                   0x00000118UL
+
+// The DC power supply is connected.
+#define PICO_POWER_SUPPLY_CONNECTED                 0x00000119UL
+
+// The DC power supply is not connected.
+// For many 4+ Channel devices this will mean a restricted feature set is offered e.g. for a 4 channel device - C and D are usually disabled.
+// Check the respective API programmers guide of your device for the full details.
+#define PICO_POWER_SUPPLY_NOT_CONNECTED             0x0000011AUL
+
+// Incorrect power mode passed for current power source.
+#define PICO_POWER_SUPPLY_REQUEST_INVALID           0x0000011BUL
+
+// The supply voltage from the USB source is too low.
+#define PICO_POWER_SUPPLY_UNDERVOLTAGE              0x0000011CUL
+
+// The oscilloscope is in the process of capturing data.
+#define PICO_CAPTURING_DATA                         0x0000011DUL
+
+// A USB 3.0 device is connected to a non-USB 3.0 port.
+#define PICO_USB3_0_DEVICE_NON_USB3_0_PORT          0x0000011EUL
+
+// A function has been called that is not supported by the current device.
+#define PICO_NOT_SUPPORTED_BY_THIS_DEVICE           0x0000011FUL
+
+// The device resolution is invalid (out of range).
+#define PICO_INVALID_DEVICE_RESOLUTION              0x00000120UL
+
+// The number of channels that can be enabled is limited in 15 and 16-bit modes.
+// (Flexible Resolution Oscilloscopes only)
+#define PICO_INVALID_NUMBER_CHANNELS_FOR_RESOLUTION 0x00000121UL
+
+// USB power not sufficient for all requested channels.
+#define PICO_CHANNEL_DISABLED_DUE_TO_USB_POWERED    0x00000122UL
+
+// The signal generator does not have a configurable DC offset.
+#define PICO_SIGGEN_DC_VOLTAGE_NOT_CONFIGURABLE     0x00000123UL
+
+// An attempt has been made to define pre-trigger delay without first enabling a trigger.
+#define PICO_NO_TRIGGER_ENABLED_FOR_TRIGGER_IN_PRE_TRIG  0x00000124UL
+
+// An attempt has been made to define pre-trigger delay without first arming a trigger.
+#define PICO_TRIGGER_WITHIN_PRE_TRIG_NOT_ARMED           0x00000125UL
+
+// Pre-trigger delay and post-trigger delay cannot be used at the same time.
+#define PICO_TRIGGER_WITHIN_PRE_NOT_ALLOWED_WITH_DELAY   0x00000126UL
+
+// The array index points to a nonexistent trigger.
+#define PICO_TRIGGER_INDEX_UNAVAILABLE                   0x00000127UL
+
+#define PICO_AWG_CLOCK_FREQUENCY									0x00000128UL
+
+// There are more than 4 analog channels with a trigger condition set.
+#define PICO_TOO_MANY_CHANNELS_IN_USE							0x00000129UL
+
+// The condition parameter is a null pointer.
+#define PICO_NULL_CONDITIONS											0x0000012AUL
+
+// There is more than one condition pertaining to the same channel.
+#define PICO_DUPLICATE_CONDITION_SOURCE						0x0000012BUL
+
+// The parameter relating to condition information is out of range.
+#define PICO_INVALID_CONDITION_INFO								0x0000012CUL
+
+// Reading the meta data has failed.
+#define PICO_SETTINGS_READ_FAILED									0x0000012DUL
+
+// Writing the meta data has failed.
+#define PICO_SETTINGS_WRITE_FAILED								0x0000012EUL
+
+// A parameter has a value out of the expected range.
+#define PICO_ARGUMENT_OUT_OF_RANGE								0x0000012FUL
+
+// The driver does not support the hardware variant connected.
+#define PICO_HARDWARE_VERSION_NOT_SUPPORTED				0x00000130UL
+
+// The driver does not support the digital hardware variant connected.
+#define PICO_DIGITAL_HARDWARE_VERSION_NOT_SUPPORTED				0x00000131UL
+
+// The driver does not support the analog hardware variant connected.
+#define PICO_ANALOGUE_HARDWARE_VERSION_NOT_SUPPORTED				0x00000132UL
+
+// Converting a channel's ADC value to resistance has failed.
+#define PICO_UNABLE_TO_CONVERT_TO_RESISTANCE			0x00000133UL
+
+// The channel is listed more than once in the function call.
+#define PICO_DUPLICATED_CHANNEL										0x00000134UL
+
+// The range cannot have resistance conversion applied.
+#define PICO_INVALID_RESISTANCE_CONVERSION				0x00000135UL
+
+// An invalid value is in the max buffer.
+#define PICO_INVALID_VALUE_IN_MAX_BUFFER					0x00000136UL
+
+// An invalid value is in the min buffer.
+#define PICO_INVALID_VALUE_IN_MIN_BUFFER					0x00000137UL
+
+// When calculating the frequency for phase conversion,
+// the frequency is greater than that supported by the current variant.
+#define PICO_SIGGEN_FREQUENCY_OUT_OF_RANGE				0x00000138UL
+
+// The device's EEPROM is corrupt. Contact Pico Technology support: https://www.picotech.com/tech-support.
+#define PICO_EEPROM2_CORRUPT											0x00000139UL
+
+// The EEPROM has failed.
+#define PICO_EEPROM2_FAIL													0x0000013AUL
+
+// The serial buffer is too small for the required information.
+#define PICO_SERIAL_BUFFER_TOO_SMALL							0x0000013BUL
+
+// The signal generator trigger and the external clock have both been set.
+// This is not allowed.
+#define PICO_SIGGEN_TRIGGER_AND_EXTERNAL_CLOCK_CLASH 0x0000013CUL
+
+// The AUX trigger was enabled and the external clock has been enabled,
+// so the AUX has been automatically disabled.
+#define PICO_WARNING_SIGGEN_AUXIO_TRIGGER_DISABLED 0x0000013DUL
+
+// The AUX I/O was set as a scope trigger and is now being set as a signal generator
+// gating trigger. This is not allowed.
+#define PICO_SIGGEN_GATING_AUXIO_NOT_AVAILABLE	 	 0x00000013EUL
+
+// The AUX I/O was set by the signal generator as a gating trigger and is now being set
+// as a scope trigger. This is not allowed.
+#define PICO_SIGGEN_GATING_AUXIO_ENABLED				 	 0x00000013FUL
+
+// A resource has failed to initialise.
+#define PICO_RESOURCE_ERROR												 0x00000140UL
+
+// The temperature type is out of range.
+#define PICO_TEMPERATURE_TYPE_INVALID							 0x000000141UL
+
+// A requested temperature type is not supported on this device.
+#define PICO_TEMPERATURE_TYPE_NOT_SUPPORTED				 0x000000142UL
+
+// A read/write to the device has timed out.
+#define PICO_TIMEOUT															 0x00000143UL
+
+// The device cannot be connected correctly.
+#define PICO_DEVICE_NOT_FUNCTIONING							   0x00000144UL
+
+// The driver has experienced an unknown error and is unable to recover from this error.
+#define PICO_INTERNAL_ERROR												 0x00000145UL
+
+// Used when opening units via IP and more than multiple units have the same IP address.
+#define PICO_MULTIPLE_DEVICES_FOUND								 0x00000146UL
+
+#define PICO_WARNING_NUMBER_OF_SEGMENTS_REDUCED 	 					0x00000147UL
+
+// The calibration pin states argument is out of range.
+#define PICO_CAL_PINS_STATES											0x00000148UL
+
+// The calibration pin frequency argument is out of range.
+#define PICO_CAL_PINS_FREQUENCY										0x00000149UL
+
+// The calibration pin amplitude argument is out of range.
+#define PICO_CAL_PINS_AMPLITUDE										0x0000014AUL
+
+// The calibration pin wavetype argument is out of range.
+#define PICO_CAL_PINS_WAVETYPE										0x0000014BUL
+
+// The calibration pin offset argument is out of range.
+#define PICO_CAL_PINS_OFFSET											0x0000014CUL
+
+// The probe's identity has a problem.
+#define PICO_PROBE_FAULT													0x0000014DUL
+
+// The probe has not been identified.
+#define PICO_PROBE_IDENTITY_UNKNOWN								0x0000014EUL
+
+// Enabling the probe would cause the device to exceed the allowable current limit.
+#define PICO_PROBE_POWER_DC_POWER_SUPPLY_REQUIRED 0x0000014FUL
+
+// The DC power supply is connected; enabling the probe would cause the device to exceed the
+// allowable current limit.
+#define PICO_PROBE_NOT_POWERED_WITH_DC_POWER_SUPPLY 0x00000150UL
+
+// Failed to complete probe configuration.
+#define	PICO_PROBE_CONFIG_FAILURE									0x00000151UL
+
+// Failed to set the callback function, as currently in current callback function.
+#define	PICO_PROBE_INTERACTION_CALLBACK						0x00000152UL
+
+// The probe has been verified but not known on this driver.
+#define	PICO_UNKNOWN_INTELLIGENT_PROBE						0x00000153UL
+
+// The intelligent probe cannot be verified.
+#define	PICO_INTELLIGENT_PROBE_CORRUPT						0x00000154UL
+
+// The callback is null, probe collection will only start when
+// first callback is a none null pointer.
+#define PICO_PROBE_COLLECTION_NOT_STARTED					0x00000155UL
+
+// The current drawn by the probe(s) has exceeded the allowed limit.
+#define PICO_PROBE_POWER_CONSUMPTION_EXCEEDED    0x00000156UL
+
+// The channel range limits have changed due to connecting or disconnecting a probe
+// the channel has been enabled.
+#define PICO_WARNING_PROBE_CHANNEL_OUT_OF_SYNC 0x00000157UL
+
+#define PICO_ENDPOINT_MISSING									 0x00000158UL
+#define PICO_UNKNOWN_ENDPOINT_REQUEST							 0x00000159UL
+
+// The ADC on board the device has not been correctly identified.
+#define PICO_ADC_TYPE_ERROR													0x0000015AUL
+
+#define PICO_FPGA2_FAILED														0x0000015BUL
+
+#define PICO_FPGA2_DEVICE_STATUS										0x0000015CUL
+
+#define PICO_ENABLE_PROGRAM_FPGA2_FAILED						0x0000015DUL
+#define PICO_NO_CHANNELS_OR_PORTS_ENABLED									0x0000015EUL
+
+#define PICO_INVALID_RATIO_MODE											0x0000015FUL
+
+#define PICO_READS_NOT_SUPPORTED_IN_CURRENT_CAPTURE_MODE 0x00000160UL
+
+// These selection tests can be masked together to show that mode than one read selection has failed the tests,
+// therefore theses error codes cover 0x00000161UL to 0x0000016FUL.
+#define PICO_TRIGGER_READ_SELECTION_CHECK_FAILED						0x00000161UL
+#define PICO_DATA_READ1_SELECTION_CHECK_FAILED						0x00000162UL
+#define PICO_DATA_READ2_SELECTION_CHECK_FAILED						0x00000164UL
+#define PICO_DATA_READ3_SELECTION_CHECK_FAILED						0x00000168UL
+
+// The requested read is not one of the reads available in enPicoReadSelection.
+#define PICO_READ_SELECTION_OUT_OF_RANGE						0x00000170UL
+
+// The downsample ratio options cannot be combined together for this request.
+#define PICO_MULTIPLE_RATIO_MODES										0x00000171UL
+
+// The enPicoReadSelection request has no samples available.
+#define PICO_NO_SAMPLES_READ			                  0x00000172UL
+
+// The enPicoReadSelection did not include one of the downsample ratios now requested.
+#define PICO_RATIO_MODE_NOT_REQUESTED								0x00000173UL
+
+// No read requests have been made.
+#define PICO_NO_USER_READ_REQUESTS_SET							0x00000174UL
+
+// The parameter for <number of values> cannot be zero.
+#define PICO_ZERO_SAMPLES_INVALID										0x00000175UL
+
+// The analog hardware cannot be identified; contact Pico Technology Technical Support.
+#define	PICO_ANALOGUE_HARDWARE_MISSING							0x00000176UL
+
+// Setting of the analog hardware pins failed.
+#define PICO_ANALOGUE_HARDWARE_PINS									0x00000177UL
+
+// An SMPS fault has occurred.
+#define PICO_ANALOGUE_HARDWARE_SMPS_FAULT						0x00000178UL
+
+// There appears to be a conflict between the expected and actual hardware in the device; contact Pico Technology Technical Support.
+#define PICO_DIGITAL_ANALOGUE_HARDWARE_CONFLICT			0x00000179UL
+
+// One or more of the enPicoRatioMode requested do not have a data buffer set.
+#define PICO_RATIO_MODE_BUFFER_NOT_SET							0x0000017AUL
+
+// The resolution is valid but not supported by the opened device.
+#define PICO_RESOLUTION_NOT_SUPPORTED_BY_VARIANT		0x0000017BUL
+
+// The requested trigger threshold is out of range for the current device resolution.
+#define PICO_THRESHOLD_OUT_OF_RANGE									0x0000017CUL
+
+// The simple trigger only supports upper edge direction options.
+#define PICO_INVALID_SIMPLE_TRIGGER_DIRECTION				0x0000017DUL
+
+// The aux trigger is not supported on this variant.
+#define PICO_AUX_NOT_SUPPORTED											0x0000017EUL
+
+// The trigger directions pointer may not be null.
+#define PICO_NULL_DIRECTIONS												0x0000017FUL
+
+// The trigger channel properties pointer may not be null.
+#define PICO_NULL_CHANNEL_PROPERTIES								0x00000180UL
+
+// A trigger is set on a channel that has not been enabled.
+#define PICO_TRIGGER_CHANNEL_NOT_ENABLED						0x00000181UL
+
+// A trigger condition has been set but a trigger property not set.
+#define PICO_CONDITION_HAS_NO_TRIGGER_PROPERTY			0x00000182UL
+
+// When requesting trigger data, this option can only be combined with the segment header ratio mode flag.
+#define PICO_RATIO_MODE_TRIGGER_MASKING_INVALID			0x00000183UL
+
+// The trigger data buffer must be 40 or more samples in size.
+#define PICO_TRIGGER_DATA_REQUIRES_MIN_BUFFER_SIZE_OF_40_SAMPLES 0x00000184UL
+
+// The number of requested waveforms is greater than the number of memory segments allocated.
+#define PICO_NO_OF_CAPTURES_OUT_OF_RANGE						0x00000185UL
+
+// When requesting segment header information, the segment header does not require a data buffer,
+// to get the segment information use GetTriggerInfo.
+#define PICO_RATIO_MODE_SEGMENT_HEADER_DOES_NOT_REQUIRE_BUFFERS	0x00000186UL
+
+// Use GetTriggerInfo to retrieve the segment header information.
+#define PICO_FOR_SEGMENT_HEADER_USE_GETTRIGGERINFO	0x00000187UL
+
+// A read request has not been set.
+#define PICO_READ_NOT_SET														0x00000188UL
+
+// The expected and actual states of the ADCs do not match.
+#define PICO_ADC_SETTING_MISMATCH										0x00000189UL
+
+// The requested data type is not one of the enPicoDataType listed.
+#define PICO_DATATYPE_INVALID												0x0000018AUL
+
+// The down sample ratio mode requested does not support the enPicoDataType option chosen.
+#define PICO_RATIO_MODE_DOES_NOT_SUPPORT_DATATYPE		0x0000018BUL
+
+// The channel combination is not valid for the resolution.
+#define PICO_CHANNEL_COMBINATION_NOT_VALID_IN_THIS_RESOLUTION 0x0000018CUL
+
+
+#define PICO_USE_8BIT_RESOLUTION										0x0000018DUL
+
+// The buffer for minimum data values and maximum data values are the same buffers.
+#define PICO_AGGREGATE_BUFFERS_SAME_POINTER					0x0000018EUL
+
+// The read request number of samples requested for an overlapped operation are more
+// than the total number of samples to capture.
+#define PICO_OVERLAPPED_READ_VALUES_OUT_OF_RANGE		0x0000018FUL
+
+// The overlapped read request has more segments specified than segments allocated.
+#define PICO_OVERLAPPED_READ_SEGMENTS_OUT_OF_RANGE	0x00000190UL
+
+// The number of channel combinations available are greater than the array size received.
+#define PICO_CHANNELFLAGSCOMBINATIONS_ARRAY_SIZE_TOO_SMALL 0x00000191UL
+
+// The number of captures is larger than the maximum number of segments allowed for the device variant.
+#define PICO_CAPTURES_EXCEEDS_NO_OF_SUPPORTED_SEGMENTS 0x00000192UL
+
+// The time unit requested is not one of the listed enPicoTimeUnits.
+#define PICO_TIME_UNITS_OUT_OF_RANGE								0x00000193UL
+
+// The number of samples parameter may not be zero.
+#define PICO_NO_SAMPLES_REQUESTED										0x00000194UL
+
+// The action requested is not listed in enPicoAction.
+#define PICO_INVALID_ACTION													0x00000195UL
+
+// When adding buffers for the same read request the buffers for all ratio mode requests have to be the same size.
+#define PICO_NO_OF_SAMPLES_NEED_TO_BE_EQUAL_WHEN_ADDING_BUFFERS 0x00000196UL
+
+// The data is being processed but there is no empty data buffers available, a new data buffer needs to be set sent to the driver
+// so that the data can be processed.
+#define PICO_WAITING_FOR_DATA_BUFFERS								0x00000197UL
+
+// when streaming data, only one read option is available.
+#define PICO_STREAMING_ONLY_SUPPORTS_ONE_READ				0x00000198UL
+
+// A clear read request is not one of the enPicoAction listed.
+#define PICO_CLEAR_DATA_BUFFER_INVALID					0x00000199UL
+
+// The combination of action flags are not allowed.
+#define PICO_INVALID_ACTION_FLAGS_COMBINATION				0x0000019AUL
+
+//  PICO_ADD request has been made but both data buffers are set to null and so there is nowhere to put the data.
+#define PICO_BOTH_MIN_AND_MAX_NULL_BUFFERS_CANNOT_BE_ADDED 0x0000019BUL
+
+// A conflict between the data buffers being set has occurred. Please use the PICO_CLEAR_ALL action to reset.
+#define PICO_CONFLICT_IN_SET_DATA_BUFFERS_CALL_REMOVE_DATA_BUFFER_TO_RESET 0x0000019CUL
+
+// While processing data, buffers cannot be removed from the data buffers list.
+#define PICO_REMOVING_DATA_BUFFER_ENTRIES_NOT_ALLOWED_WHILE_DATA_PROCESSING  0x0000019DUL
+
+//  An USB request has failed.
+#define PICO_CYUSB_REQUEST_FAILED						0x00000200UL
+
+// A request has been made to retrieve the latest streaming data, but with either a null pointer or an array size set to zero.
+#define PICO_STREAMING_DATA_REQUIRED				0x00000201UL
+
+// A buffer being set has a length that is invalid (ie less than zero).
+#define PICO_INVALID_NUMBER_OF_SAMPLES			0x00000202UL
+
+// The distribution size may not be zero.
+#define PICO_INVALID_DISTRIBUTION						0x00000203UL
+
+// The buffer length in bytes is greater than a 4-byte word.
+#define PICO_BUFFER_LENGTH_GREATER_THAN_INT32_T 0x00000204UL
+
+// The PLL has failed.
+#define PICO_PLL_MUX_OUT_FAILED             0x00000209UL
+
+// Pulse width only supports one direction.
+#define PICO_ONE_PULSE_WIDTH_DIRECTION_ALLOWED 0x0000020AUL
+
+// There is no external trigger available on the device specified by the handle.
+#define PICO_EXTERNAL_TRIGGER_NOT_SUPPORTED 0x0000020BUL
+
+// The condition parameter is a null pointer.
+#define PICO_NO_TRIGGER_CONDITIONS_SET							0x0000020CUL
+
+// The number of trigger channel properties it outside the allowed range (is less than zero).
+#define PICO_NO_OF_CHANNEL_TRIGGER_PROPERTIES_OUT_OF_RANGE 0x0000020DUL
+
+// A probe has been plugged into a channel, but can not be identified correctly.
+#define PICO_PROBE_COMPONENT_ERROR 0x0000020EUL
+
+// The probe is incompatible with the device channel it is connected to. This could lead to error in the measurements.
+#define PICO_INCOMPATIBLE_PROBE 0x0000020FUL
+
+// The requested channel for ETS triggering is not supported.
+#define PICO_INVALID_TRIGGER_CHANNEL_FOR_ETS              0x00000210UL
+
+// While the device is streaming the get values method is not available
+#define PICO_NOT_AVAILABLE_WHEN_STREAMING_IS_RUNNING 0x00000211UL
+
+// the requested state is not one of the enSharedTriggerWithinPreTrigger values
+#define PICO_INVALID_TRIGGER_WITHIN_PRE_TRIGGER_STATE 0x00000212UL
+
+// the number of captures have to be greater than zero
+#define PICO_ZERO_NUMBER_OF_CAPTURES_INVALID 0x00000213UL
+
+// the quantifier for a pointer, defining the length in bytes is invalid
+#define PICO_INVALID_LENGTH 0x00000214UL
+
+// the trigger delay is greater than supported by the hardware
+#define PICO_TRIGGER_DELAY_OUT_OF_RANGE 0x00000300UL
+
+// the requested threshold direction is not allowed with the specified channel
+#define PICO_INVALID_THRESHOLD_DIRECTION 0x00000301UL
+
+// the requested threshold mode is not allowed with the specified channel
+#define PICO_INVALID_THRESHOLD_MODE 0x00000302UL
+
+// The timebase is not supported or is invalid.
+#define PICO_TIMEBASE_NOT_SUPPORTED_BY_RESOLUTION 0x00000303UL
+
+// The device variant is not supported by this current driver.
+#define PICO_INVALID_VARIANT															0x00001000UL
+
+// The actual memory module does not match the expected memory module.
+#define PICO_MEMORY_MODULE_ERROR													0x00001001UL
+
+// A null pointer has been passed in the trigger function or one of the parameters is out of range.
+#define PICO_PULSE_WIDTH_QUALIFIER_LOWER_UPPER_CONFILCT  0x00002000UL
+
+// The pulse width qualifier type is not one of the listed options.
+#define PICO_PULSE_WIDTH_QUALIFIER_TYPE  0x00002001UL
+
+// The pulse width qualifier direction is not one of the listed options.
+#define PICO_PULSE_WIDTH_QUALIFIER_DIRECTION 0x00002002UL
+
+// The threshold range is not one of the listed options.
+#define PICO_THRESHOLD_MODE_OUT_OF_RANGE 0x00002003UL
+
+// The trigger direction and pulse width option conflict with each other.
+#define PICO_TRIGGER_AND_PULSEWIDTH_DIRECTION_IN_CONFLICT 0x00002004UL
+
+// The thresholds upper limits and thresholds lower limits conflict with each other.
+#define PICO_THRESHOLD_UPPER_LOWER_MISMATCH 0x00002005UL
+
+// The pulse width lower count is out of range.
+#define PICO_PULSE_WIDTH_LOWER_OUT_OF_RANGE	0x00002006UL
+
+// The pulse width upper count is out of range.
+#define PICO_PULSE_WIDTH_UPPER_OUT_OF_RANGE 0x00002007UL
+
+// The devices front panel has caused an error.
+#define PICO_FRONT_PANEL_ERROR 0x00002008UL
+
+// The actual and expected mode of the front panel do not match.
+#define PICO_FRONT_PANEL_MODE 0x0000200BUL
+
+// A front panel feature is not available or failed to configure.
+#define PICO_FRONT_PANEL_FEATURE 0x0000200CUL
+
+// When setting the pulse width conditions either the pointer is null or the number of conditions is set to zero.
+#define PICO_NO_PULSE_WIDTH_CONDITIONS_SET	0x0000200DUL
+
+// a trigger condition exists for a port, but the port has not been enabled
+#define PICO_TRIGGER_PORT_NOT_ENABLED 0x0000200EUL
+
+// a trigger condition exists for a port, but no digital channel directions have been set
+#define PICO_DIGITAL_DIRECTION_NOT_SET 0x0000200FUL
+
+#define PICO_I2C_DEVICE_INVALID_READ_COMMAND 0x00002010UL
+
+#define PICO_I2C_DEVICE_INVALID_RESPONSE 0x00002011UL
+
+#define PICO_I2C_DEVICE_INVALID_WRITE_COMMAND 0x00002012UL
+
+#define PICO_I2C_DEVICE_ARGUMENT_OUT_OF_RANGE 0x00002013UL
+
+// The actual and expected mode do not match.
+#define PICO_I2C_DEVICE_MODE 0x00002014UL
+
+// While trying to configure the device, set up failed.
+#define PICO_I2C_DEVICE_SETUP_FAILED 0x00002015UL
+
+// A feature is not available or failed to configure.
+#define PICO_I2C_DEVICE_FEATURE 0x00002016UL
+
+// The device did not pass the validation checks.
+#define PICO_I2C_DEVICE_VALIDATION_FAILED 0x00002017UL
+
+#define PICO_INTERNAL_HEADER_ERROR 0x00002018UL
+
+// The device couldn't write the channel settings due to a hardware fault
+#define PICO_FAILED_TO_WRITE_HARDWARE_FAULT 0x00002019UL
+
+// The number of MSO's edge transitions being set is not supported by this device (RISING, FALLING, or RISING_OR_FALLING).
+#define PICO_MSO_TOO_MANY_EDGE_TRANSITIONS_WHEN_USING_PULSE_WIDTH 0x00003000UL
+
+// A probe LED position requested is not one of the available probe positions in the ProbeLedPosition enum.
+#define PICO_INVALID_PROBE_LED_POSITION 0x00003001UL
+
+// The LED position is not supported by the selected variant.
+#define PICO_PROBE_LED_POSITION_NOT_SUPPORTED 0x00003002UL
+
+// A channel has more than one of the same LED position in the ProbeChannelLedSetting struct.
+#define PICO_DUPLICATE_PROBE_CHANNEL_LED_POSITION 0x00003003UL
+
+// Setting the probes LED has failed.
+#define PICO_PROBE_LED_FAILURE 0x00003004UL
+
+// Probe is not supported by the selected variant.
+#define PICO_PROBE_NOT_SUPPORTED_BY_THIS_DEVICE 0x00003005UL
+
+// The probe name is not in the list of enPicoConnectProbe enums.
+#define PICO_INVALID_PROBE_NAME 0x00003006UL
+
+// The number of colour settings are zero or a null pointer passed to the function.
+#define PICO_NO_PROBE_COLOUR_SETTINGS 0x00003007UL
+
+// Channel has no probe connected to it.
+#define PICO_NO_PROBE_CONNECTED_ON_REQUESTED_CHANNEL 0x00003008UL
+
+// Connected probe does not require calibration.
+#define PICO_PROBE_DOES_NOT_REQUIRE_CALIBRATION 0x00003009UL
+
+// Connected probe could not be calibrated - hardware fault is a possible cause.
+#define PICO_PROBE_CALIBRATION_FAILED 0x0000300AUL
+
+// A probe has been connected, but the version is not recognised.
+#define PICO_PROBE_VERSION_ERROR 0x0000300BUL
+
+// The channel with the frequency counter enabled has a probe connected that does not support this feature
+#define PICO_PROBE_DOES_NOT_SUPPORT_FREQUENCY_COUNTER 0x0000300CUL
+
+// The requested trigger time is to long for the selected variant.
+#define PICO_AUTO_TRIGGER_TIME_TOO_LONG   0x00004000UL
+
+// The MSO pod did not pass the validation checks.
+#define PICO_MSO_POD_VALIDATION_FAILED 0x00005000UL
+
+// No MSO pod found on the requested digital port.
+#define PICO_NO_MSO_POD_CONNECTED 0x00005001UL
+
+// the digital port enum value is not in the enPicoDigitalPortHysteresis declaration
+#define PICO_DIGITAL_PORT_HYSTERESIS_OUT_OF_RANGE 0x00005002UL
+
+#define PICO_MSO_POD_FAILED_UNIT 0x00005003UL
+
+// The device's EEPROM is corrupt. Contact Pico Technology support: https://www.picotech.com/tech-support.
+#define PICO_ATTENUATION_FAILED 0x00005004UL
+
+// a channel set to the 50Ohm Path has Tripped due to the input signal
+#define PICO_DC_50OHM_OVERVOLTAGE_TRIPPED 0x00005005UL
+
+// The MSO pod over current protection activated, unplug and replug the MSO pod 
+#define PICO_MSO_OVER_CURRENT_TRIPPED 0x00005006UL
+
+// Status error for when the device has overheated.
+#define PICO_NOT_RESPONDING_OVERHEATED 0x00005010UL
+
+// waiting for the device to capture timed out
+#define PICO_HARDWARE_CAPTURE_TIMEOUT 0x00006000UL
+
+// waiting for the device be ready for capture timed out
+#define PICO_HARDWARE_READY_TIMEOUT   0x00006001UL
+
+// the driver is performing a capture requested by RunStreaming or RunBlock
+// to interrupt this capture call Stop on the device first
+#define PICO_HARDWARE_CAPTURING_CALL_STOP   0x00006002UL
+
+// the number of samples is less than the minimum number allowed
+#define PICO_TOO_FEW_REQUESTED_STREAMING_SAMPLES 0x00007000UL
+
+// a streaming capture has been made but re-reading the data is not allowed
+#define PICO_STREAMING_REREAD_DATA_NOT_AVAILABLE 0x00007001UL
+
+// When requesting data only Raw and one of the following aggregation data types allowed
+//   - PICO_RATIO_MODE_AGGREGATE (Min Max),
+//     PICO_RATIO_MODE_DECIMATE,
+//     PICO_RATIO_MODE_AVERAGE and/or PICO_RATIO_MODE_SUM,
+//     PICO_RATIO_MODE_DISTRIBUTION
+//
+//	 average and sum are classed as one aggregation type
+#define PICO_STREAMING_COMBINATION_OF_RAW_DATA_AND_ONE_AGGREGATION_DATA_TYPE_ALLOWED 0x00007002UL
+
+// The time stamp per waveform segment has been reset.
+#define PICO_DEVICE_TIME_STAMP_RESET							0x01000000UL
+
+// When requesting the TriggerTimeOffset the trigger time has not been set.
+#define PICO_TRIGGER_TIME_NOT_REQUESTED						0x02000001UL
+
+// Trigger time buffer not set.
+#define PICO_TRIGGER_TIME_BUFFER_NOT_SET          0x02000002UL
+
+// The trigger time failed to be calculated.
+#define PICO_TRIGGER_TIME_FAILED_TO_CALCULATE     0x02000004UL
+
+// The trigger time failed to be calculated.
+#define PICO_TRIGGER_WITHIN_A_PRE_TRIGGER_FAILED_TO_CALCULATE 0x02000008UL
+
+// The trigger time stamp was not requested.
+#define PICO_TRIGGER_TIME_STAMP_NOT_REQUESTED			0x02000100UL
+
+// RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION cannot have a buffer set
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_DOES_NOT_REQUIRE_BUFFERS 0x02200000UL
+
+// it is not possible to set a buffer for RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION therefore
+// information is not available pertaining to samples
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_DOES_NOT_HAVE_BUFFERS 0x02200001UL
+
+// to get the trigger time use either GetTriggerInfo or GetTriggerTimeOffset api calls
+#define PICO_RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION_USE_GETTRIGGERINFO 0x02200002UL
+
+
+// PICO_RATIO_MDOE_TRIGGER and RATIO_MODE_TRIGGER_DATA_FOR_TIME_CALCULATION is not supported in streaming capture
+#define PICO_STREAMING_DOES_NOT_SUPPORT_TRIGGER_RATIO_MODES 0x02200003UL
+
+// only the PICO_TRIGGER_READ may be used to read PICO_RATIO_MODE_TRIGGER, and PICO_RATIO_MODE_TRIGGER_FOR_CALCULATION
+#define PICO_USE_THE_TRIGGER_READ 0x02200004UL
+
+// one of the PICO_DATA_READs should be used to read:
+// PICO_RATIO_MODE_RAW
+// PICO_RATIO_MODE_AGGREGATE
+// PICO_RATIO_MODE_DECIMATE
+// PICO_RATIO_MODE_AVERAGE
+#define PICO_USE_A_DATA_READ 0x02200005UL
+
+// trigger data always requires a PICO_INT16_T data type
+#define PICO_TRIGGER_READ_REQUIRES_INT16_T_DATA_TYPE 0x02200006UL
+
+// a ratio mode passed to the API call requires the number of samples to be greater than zero
+#define PICO_RATIO_MODE_REQUIRES_NUMBER_OF_SAMPLES_TO_BE_SET 0x02200007UL
+
+// Attempted to set up the signal generator with an inconsistent configuration.
+#define PICO_SIGGEN_SETTINGS_MISMATCH             0x03000010UL
+
+// The signal generator has been partially reconfigured and the new settings must be applied before it can be paused or restarted.
+#define PICO_SIGGEN_SETTINGS_CHANGED_CALL_APPLY   0x03000011UL
+
+// The wave type is not listed in enPicoWaveType.
+#define PICO_SIGGEN_WAVETYPE_NOT_SUPPORTED        0x03000012UL
+
+// The trigger type is not listed in enSigGenTrigType.
+#define PICO_SIGGEN_TRIGGERTYPE_NOT_SUPPORTED     0x03000013UL
+
+// The trigger source is not listed in enSigGenTrigSource.
+#define PICO_SIGGEN_TRIGGERSOURCE_NOT_SUPPORTED   0x03000014UL
+
+// The filter state is not listed in enPicoSigGenFilterState.
+#define PICO_SIGGEN_FILTER_STATE_NOT_SUPPORTED    0x03000015UL
+
+// The arbitrary waveform buffer is a null pointer.
+#define PICO_SIGGEN_NULL_PARAMETER                0x03000020UL
+
+// The arbitrary waveform buffer length is zero.
+#define PICO_SIGGEN_EMPTY_BUFFER_SUPPLIED         0x03000021UL
+
+// The sig gen voltage offset and peak to peak have not been set.
+#define PICO_SIGGEN_RANGE_NOT_SUPPLIED            0x03000022UL
+
+// The sig gen arbitrary waveform buffer not been set.
+#define PICO_SIGGEN_BUFFER_NOT_SUPPLIED           0x03000023UL
+
+// The sig gen frequency have not been set.
+#define PICO_SIGGEN_FREQUENCY_NOT_SUPPLIED        0x03000024UL
+
+// The sig gen sweep information has not been set.
+#define PICO_SIGGEN_SWEEP_INFO_NOT_SUPPLIED       0x03000025UL
+
+// The sig gen trigger information has not been set.
+#define PICO_SIGGEN_TRIGGER_INFO_NOT_SUPPLIED     0x03000026UL
+
+// The sig gen clock frequency have not been set.
+#define PICO_SIGGEN_CLOCK_FREQ_NOT_SUPPLIED       0x03000027UL
+
+// The sig gen arbitrary waveform buffer length is too long.
+#define PICO_SIGGEN_TOO_MANY_SAMPLES              0x03000030UL
+
+// The duty cycle value is out of range.
+#define PICO_SIGGEN_DUTYCYCLE_OUT_OF_RANGE        0x03000031UL
+
+// The number of cycles is out of range.
+#define PICO_SIGGEN_CYCLES_OUT_OF_RANGE           0x03000032UL
+
+// The pre-scaler is out of range.
+#define PICO_SIGGEN_PRESCALE_OUT_OF_RANGE         0x03000033UL
+
+// The sweep type is not listed in enPicoSweepType.
+#define PICO_SIGGEN_SWEEPTYPE_INVALID             0x03000034UL
+
+// A mismatch has occurred while checking the sweeps wave type.
+#define PICO_SIGGEN_SWEEP_WAVETYPE_MISMATCH       0x03000035UL
+
+// The sweeps or shots and trigger type are not valid when combined together.
+#define PICO_SIGGEN_INVALID_SWEEP_PARAMETERS      0x03000036UL
+
+// The sweep and prescaler are not valid when combined together.
+#define PICO_SIGGEN_SWEEP_PRESCALE_NOT_SUPPORTED  0x03000037UL
+
+// The potential applied to the AWG output exceeds the maximum voltage range of the AWG.
+#define PICO_AWG_OVER_VOLTAGE_RANGE               0x03000038UL
+
+// The reference signal cannot be locked to.
+#define PICO_NOT_LOCKED_TO_REFERENCE_FREQUENCY  0x03000039UL
+
+// (Linux only.) udev rules are incorrectly configured. The user does
+// not have read/write permissions on the device's file descriptor.
+#define PICO_PERMISSIONS_ERROR  0x03000040UL
+
+// The digital ports without analog channels are only allowed in 8-bit resolution.
+#define PICO_PORTS_WITHOUT_ANALOGUE_CHANNELS_ONLY_ALLOWED_IN_8BIT_RESOLUTION 0x03001000UL
+
+#define PICO_ANALOGUE_FRONTEND_MISSING 0x03003001UL
+#define PICO_FRONT_PANEL_MISSING 0x03003002UL
+#define PICO_ANALOGUE_FRONTEND_AND_FRONT_PANEL_MISSING 0x03003003UL
+
+// The digital board has reported an error to the driver
+#define PICO_DIGITAL_BOARD_HARDWARE_ERROR 0x03003800UL
+
+// checking if the firmware needs updating the updateRequired parameter is null
+#define PICO_FIRMWARE_UPDATE_REQUIRED_TO_USE_DEVICE_WITH_THIS_DRIVER		          0x03004000UL
+#define PICO_UPDATE_REQUIRED_NULL																				          0x03004001UL
+#define PICO_FIRMWARE_UP_TO_DATE																				          0x03004002UL
+#define PICO_FLASH_FAIL																									          0x03004003UL
+#define PICO_INTERNAL_ERROR_FIRMWARE_LENGTH_INVALID											          0x03004004UL
+#define PICO_INTERNAL_ERROR_FIRMWARE_NULL																          0x03004005UL
+#define PICO_FIRMWARE_FAILED_TO_BE_CHANGED															          0x03004006UL
+#define PICO_FIRMWARE_FAILED_TO_RELOAD																	          0x03004007UL
+#define PICO_FIRMWARE_FAILED_TO_BE_UPDATE																          0x03004008UL
+#define PICO_FIRMWARE_VERSION_OUT_OF_RANGE															          0x03004009UL
+
+#define PICO_OPTIONAL_BOOTLOADER_UPDATE_AVAILABLE_WITH_THIS_DRIVER	0x03005000UL
+#define PICO_BOOTLOADER_VERSION_NOT_AVAILABLE 0x03005001UL
+
+#define PICO_NO_APPS_AVAILABLE                                          0x03008000UL
+#define PICO_UNSUPPORTED_APP                                            0x03008001UL
+
+// the adc is powered down when trying to capture data
+#define PICO_ADC_POWERED_DOWN 0x03002000UL
+
+// An internal error has occurred and a watchdog timer has been called.
+#define PICO_WATCHDOGTIMER                        0x10000000UL
+
+// The picoipp.dll has not been found.
+#define PICO_IPP_NOT_FOUND                				0x10000001UL
+
+// A function in the picoipp.dll does not exist.
+#define PICO_IPP_NO_FUNCTION					            0x10000002UL
+
+// The Pico IPP call has failed.
+#define PICO_IPP_ERROR					                  0x10000003UL
+
+// Shadow calibration is not available on this device.
+#define PICO_SHADOW_CAL_NOT_AVAILABLE             0x10000004UL
+
+// Shadow calibration is currently disabled.
+#define PICO_SHADOW_CAL_DISABLED                  0x10000005UL
+
+// Shadow calibration error has occurred.
+#define PICO_SHADOW_CAL_ERROR                     0x10000006UL
+
+// The shadow calibration is corrupt.
+#define PICO_SHADOW_CAL_CORRUPT                   0x10000007UL
+
+// The memory on board the device has overflowed.
+#define PICO_DEVICE_MEMORY_OVERFLOW               0x10000008UL
+
+//The device Adc test failed.
+#define PICO_ADC_TEST_FAILURE                     0x10000010UL
+
+#define PICO_RESERVED_1														0x11000000UL
+
+// The PicoSource device is not ready to accept instructions.
+#define PICO_SOURCE_NOT_READY											0x20000000UL
+#define PICO_SOURCE_INVALID_BAUD_RATE							0x20000001UL
+#define PICO_SOURCE_NOT_OPENED_FOR_WRITE					0x20000002UL
+#define PICO_SOURCE_FAILED_TO_WRITE_DEVICE				0x20000003UL
+#define PICO_SOURCE_EEPROM_FAIL										0x20000004UL
+#define PICO_SOURCE_EEPROM_NOT_PRESENT 						0x20000005UL
+#define PICO_SOURCE_EEPROM_NOT_PROGRAMMED					0x20000006UL
+#define PICO_SOURCE_LIST_NOT_READY								0x20000007UL
+#define PICO_SOURCE_FTD2XX_NOT_FOUND							0x20000008UL
+#define PICO_SOURCE_FTD2XX_NO_FUNCTION						0x20000009UL
+
+typedef uint32_t PICO_STATUS;
+
+typedef enum enPicoStringValue
+{
+	PICO_SV_MEMORY,
+	PICO_SV_MEMORY_NO_OF_SEGMENTS,
+	PICO_SV_MEMORY_MAX_SAMPLES,
+
+	PICO_SV_NO_OF_CHANNELS,
+	PICO_SV_ARRAY_OF_CHANNELS,
+	PICO_SV_CHANNEL,
+	PICO_SV_CHANNEL_NAME,
+	PICO_SV_CHANNEL_RANGE,
+	PICO_SV_CHANNEL_COUPLING,
+	PICO_SV_CHANNEL_ENABLED,
+	PICO_SV_CHANNEL_ANALOGUE_OFFSET,
+	PICO_SV_CHANNEL_FILTER,
+
+	PICO_SV_TRIGGER,
+	PICO_SV_TRIGGER_AUXIO_OUTPUT_ENABLED,
+	PICO_SV_TRIGGER_AUTO_TRIGGER_MICROSECONDS,
+
+	PICO_SV_TRIGGER_PROPERTIES,
+	PICO_SV_NO_OF_TRIGGER_PROPERTIES,
+
+	PICO_SV_TRIGGER_PROPERTIES_CHANNEL,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_UPPER,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_UPPER_HYSTERESIS,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_LOWER,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_LOWER_HYSTERESIS,
+	PICO_SV_TRIGGER_PROPERTIES_THRESHOLD_MODE,
+
+	PICO_SV_TRIGGER_ARRAY_OF_BLOCK_CONDITIONS,
+	PICO_SV_TRIGGER_NO_OF_BLOCK_CONDITIONS,
+	PICO_SV_TRIGGER_CONDITIONS,
+	PICO_SV_TRIGGER_NO_OF_CONDITIONS,
+	PICO_SV_TRIGGER_CONDITION_SOURCE,
+	PICO_SV_TRIGGER_CONDITION_STATE,
+
+	PICO_SV_TRIGGER_DIRECTION,
+	PICO_SV_TRIGGER_NO_OF_DIRECTIONS,
+	PICO_SV_TRIGGER_DIRECTION_CHANNEL,
+	PICO_SV_TRIGGER_DIRECTION_DIRECTION,
+
+	PICO_SV_TRIGGER_DELAY,
+	PICO_SV_TRIGGER_DELAY_MS,
+
+	PICO_SV_FREQUENCY_COUNTER,
+	PICO_SV_FREQUENCY_COUNTER_ENABLED,
+	PICO_SV_FREQUENCY_COUNTER_CHANNEL,
+	PICO_SV_FREQUENCY_COUNTER_RANGE,
+	PICO_SV_FREQUENCY_COUNTER_TRESHOLDMAJOR,
+	PICO_SV_FREQUENCY_COUNTER_TRESHOLDMINOR,
+
+	PICO_SV_PULSE_WIDTH_PROPERTIES,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_DIRECTION,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_LOWER,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_UPPER,
+	PICO_SV_PULSE_WIDTH_PROPERTIES_TYPE,
+
+	PICO_SV_PULSE_WIDTH_ARRAY_OF_BLOCK_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_NO_OF_BLOCK_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_NO_OF_CONDITIONS,
+	PICO_SV_PULSE_WIDTH_CONDITIONS_SOURCE,
+	PICO_SV_PULSE_WIDTH_CONDITIONS_STATE,
+
+	PICO_SV_SAMPLE_PROPERTIES,
+	PICO_SV_SAMPLE_PROPERTIES_PRE_TRIGGER_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_POST_TRIGGER_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_TIMEBASE,
+	PICO_SV_SAMPLE_PROPERTIES_NO_OF_CAPTURES,
+	PICO_SV_SAMPLE_PROPERTIES_RESOLUTION,
+
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_DOWN_SAMPLE_RATIO,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_DOWN_SAMPLE_RATIO_MODE,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_REQUERSTED_NO_OF_SAMPLES,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_SEGMENT_INDEX_FROM,
+	PICO_SV_SAMPLE_PROPERTIES_OVERLAPPED_SEGMENT_INDEX_TO,
+
+	PICO_SV_SIGNAL_GENERATOR,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_WAVE_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_START_FREQUENCY,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_STOP_FREQUENCY,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_INCREMENT,
+	PICO_SV_SIGNAL_GENERATOR_BUILT_IN_DWELL_TIME,
+	PICO_SV_SIGNAL_GENERATOR_AWG,
+	PICO_SV_SIGNAL_GENERATOR_AWG_START_DELTA_PHASE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_STOP_DELTA_PHASE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_DELTA_PHASE_INCREMENT,
+	PICO_SV_SIGNAL_GENERATOR_AWG_DWELL_COUNT,
+	PICO_SV_SIGNAL_GENERATOR_AWG_INDEX_MODE,
+	PICO_SV_SIGNAL_GENERATOR_AWG_WAVEFORM_SIZE,
+	PICO_SV_SIGNAL_GENERATOR_ARRAY_OF_AWG_WAVEFORM_VALUES,
+	PICO_SV_SIGNAL_GENERATOR_OFFSET_VOLTAGE,
+	PICO_SV_SIGNAL_GENERATOR_PK_TO_PK,
+	PICO_SV_SIGNAL_GENERATOR_OPERATION,
+	PICO_SV_SIGNAL_GENERATOR_SHOTS,
+	PICO_SV_SIGNAL_GENERATOR_SWEEPS,
+	PICO_SV_SIGNAL_GENERATOR_SWEEP_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_TRIGGER_TYPE,
+	PICO_SV_SIGNAL_GENERATOR_TRIGGER_SOURCE,
+	PICO_SV_SIGNAL_GENERATOR_EXT_IN_THRESHOLD,
+
+	PICO_SV_ETS,
+	PICO_SV_ETS_STATE,
+	PICO_SV_ETS_CYCLE,
+	PICO_SV_ETS_INTERLEAVE,
+	PICO_SV_ETS_SAMPLE_TIME_PICOSECONDS
+
+} PICO_STRING_VALUE;
+
+#endif

+ 1286 - 0
pico-tcp-service/pico-tcp/libps4000a/ps4000aApi.h

@@ -0,0 +1,1286 @@
+/****************************************************************************
+ *
+ * Filename:    ps4000aApi.h
+ * Author:      MAS
+ * Description:
+ *
+ * This header defines the interface to driver routines for the
+ *	PicoScope 4444 and 4824 PC Oscilloscopes.
+ *
+ * Copyright � 2013 - 2022 Pico Technology Ltd. All rights reserved.
+ *
+ ****************************************************************************/
+#ifndef __PS4000AAPI_H__
+#define __PS4000AAPI_H__
+
+#include <stdint.h>
+
+#include "PicoStatus.h"
+#include "../inc/PicoCallback.h"
+#include "../inc/PicoConnectProbes.h"
+#include "../inc/PicoVersion.h"
+
+#ifdef PREF0
+  #undef PREF0
+#endif
+#ifdef PREF1
+  #undef PREF1
+#endif
+#ifdef PREF2
+  #undef PREF2
+#endif
+#ifdef PREF3
+  #undef PREF3
+#endif
+
+#ifdef __cplusplus
+	#define PREF0 extern "C"
+#else
+	#define PREF0
+#endif
+
+#ifdef WIN32
+/*	If you are dynamically linking ps4000a.dll into your project #define DYNLINK here
+ */
+#ifdef DYNLINK
+  #define PREF1 typedef
+	#define PREF2
+	#define PREF3(x) (__stdcall *x)
+#else
+  #define PREF1
+	#ifdef _USRDLL
+		#define PREF2 __declspec(dllexport) __stdcall
+	#else
+		#define PREF2 __declspec(dllimport) __stdcall
+	#endif
+  #define PREF3(x) x
+#endif
+	#define PREF4 __stdcall
+#else
+
+	/* Define a 64-bit integer type */
+	#ifdef DYNLINK
+		#define PREF1 typedef
+		#define PREF2
+		#define PREF3(x) (*x)
+	#else
+		#ifdef _USRDLL
+			#define PREF1 __attribute__((visibility("default")))
+		#else
+			#define PREF1
+		#endif
+		#define PREF2
+		#define PREF3(x) x
+	#endif
+	#define PREF4
+#endif
+
+#define PS4000A_EXT_MAX_VALUE  32767
+#define PS4000A_EXT_MIN_VALUE -32767
+
+#define MAX_PULSE_WIDTH_QUALIFIER_COUNT 16777215L
+#define MAX_DELAY_COUNT 8388607L
+
+#define PS4000A_MAX_SIG_GEN_BUFFER_SIZE 16384
+
+#define PS4000A_MIN_SIG_GEN_BUFFER_SIZE 10
+#define PS4000A_MIN_DWELL_COUNT				10
+#define PS4000A_MAX_SWEEPS_SHOTS				((1 << 30) - 1)
+#define	PS4000A_AWG_DAC_FREQUENCY							80e6
+#define	PS4000A_AWG_PHASE_ACCUMULATOR  4294967296.0
+
+#define PS4000A_MAX_ANALOGUE_OFFSET_50MV_200MV	 0.250f
+#define PS4000A_MIN_ANALOGUE_OFFSET_50MV_200MV	-0.250f
+#define PS4000A_MAX_ANALOGUE_OFFSET_500MV_2V		 2.500f
+#define PS4000A_MIN_ANALOGUE_OFFSET_500MV_2V		-2.500f
+#define PS4000A_MAX_ANALOGUE_OFFSET_5V_20V			 20.f
+#define PS4000A_MIN_ANALOGUE_OFFSET_5V_20V			-20.f
+#define PS4000A_MAX_ANALOGUE_OFFSET_10V_50V      25.f
+#define PS4000A_MIN_ANALOGUE_OFFSET_10V_50V     -25.f
+
+
+typedef enum enPS4000ADeviceResolution
+{
+	PS4000A_DR_8BIT,
+	PS4000A_DR_12BIT,
+	PS4000A_DR_14BIT,
+	PS4000A_DR_15BIT,
+	PS4000A_DR_16BIT,
+} PS4000A_DEVICE_RESOLUTION;
+
+typedef enum enPS4000AExtraOperations
+{
+	PS4000A_ES_OFF,
+	PS4000A_WHITENOISE,
+	PS4000A_PRBS // Pseudo-Random Bit Stream
+} PS4000A_EXTRA_OPERATIONS;
+
+typedef enum	enPS4000ABandwidthLimiterFlags
+{
+	PS4000A_BW_FULL_FLAG = (1 << 0),
+	PS4000A_BW_20KHZ_FLAG = (1 << 1),
+	PS4000A_BW_100KHZ_FLAG = (1 << 2), //( default when current clamp detected: can be changed)
+	PS4000A_BW_1MHZ_FLAG  = (1 << 3)  //( default for 14 bits: can be changed)
+} PS4000A_BANDWIDTH_LIMITER_FLAGS;
+
+typedef enum	enPS4000ABandwidthLimiter
+{
+	PS4000A_BW_FULL,
+	PS4000A_BW_20KHZ,
+	PS4000A_BW_100KHZ, //( default when current clamp detected: can be changed)
+	PS4000A_BW_1MHZ
+} PS4000A_BANDWIDTH_LIMITER;
+
+typedef enum enPS4000ACoupling
+{
+	PS4000A_AC,
+	PS4000A_DC
+} PS4000A_COUPLING;
+
+typedef enum enPS4000AChannel
+{
+	PS4000A_CHANNEL_A,
+	PS4000A_CHANNEL_B,
+	PS4000A_CHANNEL_C,
+	PS4000A_CHANNEL_D,
+	PS4000A_MAX_4_CHANNELS,
+	PS4000A_CHANNEL_E = PS4000A_MAX_4_CHANNELS,
+	PS4000A_CHANNEL_F,
+	PS4000A_CHANNEL_G,
+	PS4000A_CHANNEL_H,
+	PS4000A_EXTERNAL,
+	PS4000A_MAX_CHANNELS = PS4000A_EXTERNAL,
+	PS4000A_TRIGGER_AUX,
+	PS4000A_MAX_TRIGGER_SOURCES,
+	PS4000A_PULSE_WIDTH_SOURCE = 0x10000000
+}	PS4000A_CHANNEL;
+
+
+
+typedef enum enPS4000AChannelBufferIndex
+{
+	PS4000A_CHANNEL_A_MAX,
+	PS4000A_CHANNEL_A_MIN,
+	PS4000A_CHANNEL_B_MAX,
+	PS4000A_CHANNEL_B_MIN,
+	PS4000A_CHANNEL_C_MAX,
+	PS4000A_CHANNEL_C_MIN,
+	PS4000A_CHANNEL_D_MAX,
+	PS4000A_CHANNEL_D_MIN,
+	PS4000A_CHANNEL_E_MAX,
+	PS4000A_CHANNEL_E_MIN,
+	PS4000A_CHANNEL_F_MAX,
+	PS4000A_CHANNEL_F_MIN,
+	PS4000A_CHANNEL_G_MAX,
+	PS4000A_CHANNEL_G_MIN,
+	PS4000A_CHANNEL_H_MAX,
+	PS4000A_CHANNEL_H_MIN,
+	PS4000A_MAX_CHANNEL_BUFFERS
+} PS4000A_CHANNEL_BUFFER_INDEX;
+
+typedef enum enPS4000ARange
+{
+	PS4000A_10MV,
+	PS4000A_20MV,
+	PS4000A_50MV,
+	PS4000A_100MV,
+	PS4000A_200MV,
+	PS4000A_500MV,
+	PS4000A_1V,
+	PS4000A_2V,
+	PS4000A_5V,
+	PS4000A_10V,
+	PS4000A_20V,
+	PS4000A_50V,
+	PS4000A_100V,
+	PS4000A_200V,
+	PS4000A_MAX_RANGES
+}	PS4000A_RANGE;
+
+typedef enum enPS4000AResistanceRange
+{
+	PS4000A_RESISTANCE_315K = 0x00000200,
+	PS4000A_RESISTANCE_1100K,
+	PS4000A_RESISTANCE_10M,
+	PS4000A_MAX_RESISTANCE_RANGES = (PS4000A_RESISTANCE_10M + 1) - PS4000A_RESISTANCE_315K,
+	PS4000A_RESISTANCE_ADCV = 0x10000000
+}	PS4000A_RESISTANCE_RANGE;
+
+typedef enum enPS4000AEtsMode
+  {
+  PS4000A_ETS_OFF,             // ETS disabled
+  PS4000A_ETS_FAST,            // Return ready as soon as requested no of interleaves is available
+  PS4000A_ETS_SLOW,            // Return ready every time a new set of no_of_cycles is collected
+  PS4000A_ETS_MODES_MAX
+  }	PS4000A_ETS_MODE;
+
+typedef enum enPS4000ATimeUnits
+  {
+  PS4000A_FS,
+  PS4000A_PS,
+  PS4000A_NS,
+  PS4000A_US,
+  PS4000A_MS,
+  PS4000A_S,
+  PS4000A_MAX_TIME_UNITS,
+  }	PS4000A_TIME_UNITS;
+
+typedef enum enPS4000ASweepType
+{
+	PS4000A_UP,
+	PS4000A_DOWN,
+	PS4000A_UPDOWN,
+	PS4000A_DOWNUP,
+	PS4000A_MAX_SWEEP_TYPES
+} PS4000A_SWEEP_TYPE;
+
+typedef enum enPS4000AWaveType
+{
+	PS4000A_SINE,
+	PS4000A_SQUARE,
+	PS4000A_TRIANGLE,
+	PS4000A_RAMP_UP,
+	PS4000A_RAMP_DOWN,
+	PS4000A_SINC,
+	PS4000A_GAUSSIAN,
+	PS4000A_HALF_SINE,
+	PS4000A_DC_VOLTAGE,
+	PS4000A_WHITE_NOISE,
+	PS4000A_MAX_WAVE_TYPES
+} PS4000A_WAVE_TYPE;
+
+typedef enum enPS4000APinStates
+{
+	PS4000A_CAL_PINS_OFF,
+	PS4000A_GND_SIGNAL,
+	PS4000A_SIGNAL_SIGNAL
+} PS4000A_PIN_STATES;
+
+#define PS4000A_SINE_MAX_FREQUENCY				1000000.f
+#define PS4000A_SQUARE_MAX_FREQUENCY			1000000.f
+#define PS4000A_TRIANGLE_MAX_FREQUENCY		1000000.f
+#define PS4000A_SINC_MAX_FREQUENCY				1000000.f
+#define PS4000A_RAMP_MAX_FREQUENCY				1000000.f
+#define PS4000A_HALF_SINE_MAX_FREQUENCY	1000000.f
+#define PS4000A_GAUSSIAN_MAX_FREQUENCY		1000000.f
+#define PS4000A_MIN_FREQUENCY									 0.03f
+
+typedef enum enPS4000AChannelLed
+{
+	PS4000A_CHANNEL_LED_OFF,
+	PS4000A_CHANNEL_LED_RED,
+	PS4000A_CHANNEL_LED_GREEN
+} PS4000A_CHANNEL_LED;
+
+typedef enum enPS4000AProbeLedPosition
+{
+	PS4000A_UPPER_LEFT_LED = 1,
+	PS4000A_LOWER_LEFT_LED = 2,
+	PS4000A_UPPER_RIGHT_LED = 4,
+	PS4000A_LOWER_RIGHT_LED = 8,
+
+	PS4000A_RIGHT_LEDS = PS4000A_UPPER_RIGHT_LED | PS4000A_LOWER_RIGHT_LED,
+	PS4000A_LEFT_LEDS = PS4000A_UPPER_LEFT_LED | PS4000A_LOWER_LEFT_LED,
+
+	PS4000A_UPPER_LEDS = PS4000A_UPPER_RIGHT_LED | PS4000A_UPPER_LEFT_LED,
+	PS4000A_LOWER_LEDS = PS4000A_LOWER_RIGHT_LED | PS4000A_LOWER_LEFT_LED,
+
+	PS4000A_ALL_LEDS = PS4000A_UPPER_LEFT_LED | PS4000A_LOWER_LEFT_LED | PS4000A_UPPER_RIGHT_LED | PS4000A_LOWER_RIGHT_LED
+} PS4000A_PROBE_LED_POSITION;
+
+typedef enum enPS4000AMetaType
+{
+	PS4000A_MT_UNIT_INFO,
+	PS4000A_MT_DEVICE_CAPABILITY,
+	PS4000A_MT_DEVICE_SETTINGS,
+	PS4000A_MT_SIGNAL_GENERATOR_SETTINGS
+} PS4000A_META_TYPE;
+
+typedef enum enPS4000AMetaOperation
+{
+	PS4000A_MO_READ,
+	PS4000A_MO_WRITE
+} PS4000A_META_OPERATION;
+
+typedef enum enPS4000AMetaFormat
+{
+	PS4000A_MF_COMMA_SEPARATED,
+	PS4000A_MF_XML
+} PS4000A_META_FORMAT;
+
+typedef enum enPS4000ASigGenTrigType
+{
+	PS4000A_SIGGEN_RISING,
+	PS4000A_SIGGEN_FALLING,
+	PS4000A_SIGGEN_GATE_HIGH,
+	PS4000A_SIGGEN_GATE_LOW
+} PS4000A_SIGGEN_TRIG_TYPE;
+
+typedef enum enPS4000ASigGenTrigSource
+{
+	PS4000A_SIGGEN_NONE,
+	PS4000A_SIGGEN_SCOPE_TRIG,
+	PS4000A_SIGGEN_AUX_IN,
+	PS4000A_SIGGEN_EXT_IN,
+	PS4000A_SIGGEN_SOFT_TRIG
+} PS4000A_SIGGEN_TRIG_SOURCE;
+
+typedef enum enPS4000AIndexMode
+{
+	PS4000A_SINGLE,
+	PS4000A_DUAL,
+	PS4000A_QUAD,
+	PS4000A_MAX_INDEX_MODES
+} PS4000A_INDEX_MODE;
+
+typedef enum enPS4000AThresholdMode
+{
+	PS4000A_LEVEL,
+	PS4000A_WINDOW
+} PS4000A_THRESHOLD_MODE;
+
+typedef enum enPS4000AThresholdDirection
+{
+	PS4000A_ABOVE, //using upper threshold
+	PS4000A_BELOW, //using upper threshold
+	PS4000A_RISING, // using upper threshold
+	PS4000A_FALLING, // using upper threshold
+	PS4000A_RISING_OR_FALLING, // using both threshold
+	PS4000A_ABOVE_LOWER, // using lower threshold
+	PS4000A_BELOW_LOWER, // using lower threshold
+	PS4000A_RISING_LOWER,			 // using lower threshold
+	PS4000A_FALLING_LOWER,		 // using lower threshold
+
+	// Windowing using both thresholds
+	PS4000A_INSIDE = PS4000A_ABOVE,
+	PS4000A_OUTSIDE = PS4000A_BELOW,
+	PS4000A_ENTER = PS4000A_RISING,
+	PS4000A_EXIT = PS4000A_FALLING,
+	PS4000A_ENTER_OR_EXIT = PS4000A_RISING_OR_FALLING,
+	PS4000A_POSITIVE_RUNT = 9,
+  PS4000A_NEGATIVE_RUNT,
+
+	// no trigger set
+  PS4000A_NONE = PS4000A_RISING
+} PS4000A_THRESHOLD_DIRECTION;
+
+
+typedef enum enPS4000ATriggerState
+{
+  PS4000A_CONDITION_DONT_CARE,
+  PS4000A_CONDITION_TRUE,
+  PS4000A_CONDITION_FALSE,
+	PS4000A_CONDITION_MAX
+} PS4000A_TRIGGER_STATE;
+
+typedef enum enPS4000ASensorState
+{
+	PS4000A_CONNECT_STATE_FLOATING,
+	PS4000A_SENSOR_STATE_CONNECTED
+} PS4000A_SENSOR_STATE;
+
+typedef enum enPS4000AFrequencyCounterRange
+{
+  PS4000A_FC_2K,
+  PS4000A_FC_20K,
+  PS4000A_FC_20,
+  PS4000A_FC_200,
+  PS4000A_FC_MAX
+}PS4000A_FREQUENCY_COUNTER_RANGE;
+
+typedef enum enPS4000AChannelFlags
+{
+	PS4000A_CHANNEL_A_FLAGS = 1,
+	PS4000A_CHANNEL_B_FLAGS = 2,
+	PS4000A_CHANNEL_C_FLAGS = 4,
+	PS4000A_CHANNEL_D_FLAGS = 8,
+	PS4000A_CHANNEL_E_FLAGS = 16,
+	PS4000A_CHANNEL_F_FLAGS = 32,
+	PS4000A_CHANNEL_G_FLAGS = 64,
+	PS4000A_CHANNEL_H_FLAGS = 128,
+}	PS4000A_CHANNEL_FLAGS;
+
+#pragma pack(push,1)
+typedef struct tPS4000AChannelLedSetting
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_CHANNEL_LED state;
+} PS4000A_CHANNEL_LED_SETTING;
+
+typedef struct ps4000aProbeLedColour
+{
+	uint8_t red;
+	uint8_t green;
+	uint8_t blue;
+} PS4000A_PROBE_LED_COLOUR;
+
+typedef struct tPS4000AProbeChannelLedSetting
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_PROBE_LED_POSITION position;
+	PS4000A_PROBE_LED_COLOUR rgb;
+} PS4000A_PROBE_CHANNEL_LED_SETTING;
+
+typedef struct tPS4000ADirection
+{
+	PS4000A_CHANNEL							channel;
+	PS4000A_THRESHOLD_DIRECTION direction;
+} PS4000A_DIRECTION;
+
+
+typedef struct tPS4000ACondition
+{
+	PS4000A_CHANNEL   		source;
+  PS4000A_TRIGGER_STATE condition;
+} PS4000A_CONDITION;
+
+typedef enum enPS4000AConditionsInfo
+{
+	PS4000A_CLEAR = 0x00000001,
+  PS4000A_ADD = 0x00000002
+} PS4000A_CONDITIONS_INFO;
+
+typedef struct tPS4000ATriggerChannelProperties
+{
+  int16_t										thresholdUpper;
+	uint16_t					thresholdUpperHysteresis;
+  int16_t										thresholdLower;
+	uint16_t					thresholdLowerHysteresis;
+	PS4000A_CHANNEL					channel;
+  PS4000A_THRESHOLD_MODE	thresholdMode;
+} PS4000A_TRIGGER_CHANNEL_PROPERTIES;
+
+typedef struct tPS4000AConnectDetect
+{
+	PS4000A_CHANNEL channel;
+	PS4000A_SENSOR_STATE state;
+} PS4000A_CONNECT_DETECT;
+
+typedef struct tPS4000AUserProbeInteractions
+{
+	uint16_t connected;
+
+	PS4000A_CHANNEL channel;
+	uint16_t enabled;
+
+	PicoConnectProbe probeName;
+
+	uint8_t requiresPower_;
+	uint8_t isPowered_;
+
+	PICO_STATUS status_;
+
+	PICO_CONNECT_PROBE_RANGE probeOff;
+
+	PICO_CONNECT_PROBE_RANGE rangeFirst_;
+	PICO_CONNECT_PROBE_RANGE rangeLast_;
+	PICO_CONNECT_PROBE_RANGE rangeCurrent_;
+
+	PS4000A_COUPLING couplingFirst_;
+	PS4000A_COUPLING couplingLast_;
+	PS4000A_COUPLING couplingCurrent_;
+
+	PS4000A_BANDWIDTH_LIMITER_FLAGS filterFlags_;
+	PS4000A_BANDWIDTH_LIMITER_FLAGS filterCurrent_;
+
+	PS4000A_BANDWIDTH_LIMITER defaultFilter_;
+} PS4000A_USER_PROBE_INTERACTIONS;
+#pragma pack(pop)
+
+
+typedef enum enPS4000ARatioMode
+{
+	PS4000A_RATIO_MODE_NONE = 0,
+	PS4000A_RATIO_MODE_AGGREGATE = 1,
+	PS4000A_RATIO_MODE_DECIMATE = 2,
+	PS4000A_RATIO_MODE_AVERAGE = 4,
+	PS4000A_RATIO_MODE_DISTRIBUTION = 8
+} PS4000A_RATIO_MODE;
+
+typedef enum enPS4000APulseWidthType
+{
+	PS4000A_PW_TYPE_NONE,
+  PS4000A_PW_TYPE_LESS_THAN,
+	PS4000A_PW_TYPE_GREATER_THAN,
+	PS4000A_PW_TYPE_IN_RANGE,
+	PS4000A_PW_TYPE_OUT_OF_RANGE
+} PS4000A_PULSE_WIDTH_TYPE;
+
+typedef enum enPS4000AChannelInfo
+{
+	PS4000A_CI_RANGES,
+	PS4000A_CI_RESISTANCES,
+} PS4000A_CHANNEL_INFO;
+
+typedef void (PREF4 *ps4000aBlockReady)
+	(
+		int16_t											handle,
+		PICO_STATUS								status,
+		void										*	pParameter
+	);
+
+typedef void (PREF4 *ps4000aStreamingReady)
+	(
+		int16_t    									handle,
+		int32_t     									noOfSamples,
+		uint32_t							startIndex,
+		int16_t    									overflow,
+		uint32_t							triggerAt,
+		int16_t    									triggered,
+		int16_t    									autoStop,
+		void										*	pParameter
+	);
+
+
+typedef void (PREF4 *ps4000aDataReady)
+	(
+		int16_t    									handle,
+		PICO_STATUS								status,
+		uint32_t     				noOfSamples,
+		int16_t    									overflow,
+		void										*	pParameter
+	);
+
+
+typedef void (PREF4 *ps4000aProbeInteractions)
+	(
+		int16_t    												handle,
+		PICO_STATUS												status,
+		PS4000A_USER_PROBE_INTERACTIONS * probes,
+		uint32_t													nProbes
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aOpenUnitWithResolution)
+(
+	int16_t											* handle,
+	int8_t											* serial,
+	PS4000A_DEVICE_RESOLUTION			resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnit)
+  (
+	  int16_t											* handle,
+		int8_t											* serial
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aOpenUnitAsyncWithResolution)
+(
+	int16_t											* status,
+	int8_t											* serial,
+	PS4000A_DEVICE_RESOLUTION			resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnitAsync)
+  (
+	  int16_t											* status,
+		int8_t											* serial
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aOpenUnitProgress)
+	(
+	  int16_t 										* handle,
+	  int16_t 										* progressPercent,
+	  int16_t 										* complete
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetUnitInfo)
+ 	(
+	  int16_t     								  handle,
+	  int8_t      								* string,
+	  int16_t     								  stringLength,
+	  int16_t     								* requiredSize,
+	  PICO_INFO 								  info
+	);
+
+// This function retrieves information about the accessory (e.g. probe) attached to the specified channel.
+// Note: you must set a probe interaction callback to be able to retrieve probe information.
+//
+// parameters:
+// handle: identifies the device to which the accessory is attached.
+// channel: identifies the channel to which the accessory is attached. If no accessory is connected to this channel, an error will result.
+// string: on exit, the accessory information string selected specified by the info argument. If string is NULL, only requiredSize is returned.
+// stringLength: the maximum number of 8-bit integers (int8_t) that may be written to string.
+// requiredSize: on exit, the required length of the string array.
+// info: a number specifying what information is required. Note that unlike ps6000aGetUnitInfo, only PICO_BATCH_AND_SERIAL and PICO_CAL_DATE are valid for accessories.
+//
+// return:
+// PICO_OK
+// PICO_INVALID_HANDLE (handle isn't that of an open PicoScope device.)
+// PICO_PROBE_COLLECTION_NOT_STARTED (handle hasn't got a probe interaction callback set).
+// PICO_INVALID_CHANNEL (channel doesn't map to a channel on the device with handle.)
+// PICO_NULL_PARAMETER (requiredSize is NULL.)
+// PICO_INVALID_INFO (info is an invalid value for the attached accessory.)
+// PICO_INFO_UNAVAILABLE (no accessory is connected, or the connected accessory does not support any info.)
+// PICO_DRIVER_FUNCTION (another thread is already calling a driver function.)
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetAccessoryInfo)
+  (
+	  int16_t     								  handle,
+	  PS4000A_CHANNEL							  channel,
+	  int8_t											* string,
+	  int16_t     								  stringLength,
+	  int16_t											* requiredSize,
+	  PICO_INFO 								  info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aFlashLed)
+	(
+	  int16_t 											handle,
+		int16_t 											start
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetChannelLed)
+	(
+	int16_t 												handle,
+	PS4000A_CHANNEL_LED_SETTING		*	ledStates,
+	uint16_t												nLedStates
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsLedFlashing)
+	(
+	  int16_t 										  handle,
+		int16_t 										* status
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aCloseUnit)
+	(
+	  int16_t												handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMemorySegments)
+	(
+	  int16_t												handle,
+		uint32_t								nSegments,
+		int32_t											* nMaxSamples
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetChannel)
+ 	(
+	  int16_t											handle,
+		PS4000A_CHANNEL						channel,
+	  int16_t											enabled,
+	  PS4000A_COUPLING					type,
+		PICO_CONNECT_PROBE_RANGE				range,
+		float											analogOffset
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetBandwidthFilter)
+ 	(
+	  int16_t												handle,
+	  PS4000A_CHANNEL							channel,
+	  PS4000A_BANDWIDTH_LIMITER		bandwidth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aApplyResistanceScaling)
+	(
+	int16_t											handle,
+	PS4000A_CHANNEL							channel,
+	PICO_CONNECT_PROBE_RANGE					range,
+	int16_t										* bufferMax,
+	int16_t										* bufferMin,
+	uint32_t										buffertLth,
+	int16_t										* overflow
+	);
+
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTimebase)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   int32_t											* timeIntervalNanoseconds,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTimebase2)
+	(
+	   int16_t											handle,
+	   uint32_t							timebase,
+	   int32_t												noSamples,
+	   float										* timeIntervalNanoseconds,
+		 int32_t											* maxSamples,
+		 uint32_t							segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSigGenArbitrary)
+	(
+	 	int16_t												handle,
+	 	int32_t												offsetVoltage,
+	 	uint32_t								pkToPk,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+	 	int16_t											*	arbitraryWaveform,
+	 	int32_t												arbitraryWaveformSize,
+		PS4000A_SWEEP_TYPE					sweepType,
+		PS4000A_EXTRA_OPERATIONS		operation,
+		PS4000A_INDEX_MODE					indexMode,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetSigGenBuiltIn)
+	(
+		int16_t												handle,
+		int32_t												offsetVoltage,
+		uint32_t								pkToPk,
+		PS4000A_WAVE_TYPE						waveType,
+		double											startFrequency,
+		double											stopFrequency,
+		double											increment,
+		double											dwellTime,
+		PS4000A_SWEEP_TYPE					sweepType,
+		PS4000A_EXTRA_OPERATIONS		operation,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+		);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSigGenPropertiesArbitrary)
+	(
+	 	int16_t												handle,
+	 	uint32_t								startDeltaPhase,
+	 	uint32_t								stopDeltaPhase,
+	 	uint32_t								deltaPhaseIncrement,
+	 	uint32_t								dwellCount,
+		PS4000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetSigGenPropertiesBuiltIn)
+	(
+		int16_t												handle,
+		double											startFrequency,
+		double											stopFrequency,
+		double											increment,
+		double											dwellTime,
+		PS4000A_SWEEP_TYPE					sweepType,
+		uint32_t								shots,
+		uint32_t								sweeps,
+		PS4000A_SIGGEN_TRIG_TYPE		triggerType,
+		PS4000A_SIGGEN_TRIG_SOURCE	triggerSource,
+		int16_t												extInThreshold
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSigGenFrequencyToPhase)
+	(
+		int16_t												handle,
+		double												frequency,
+		PS4000A_INDEX_MODE						indexMode,
+		uint32_t											bufferLength,
+		uint32_t										* phase
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSigGenArbitraryMinMaxValues)
+	(
+	int16_t			handle,
+	int16_t		*	minArbitraryWaveformValue,
+	int16_t		*	maxArbitraryWaveformValue,
+	uint32_t	* minArbitraryWaveformSize,
+	uint32_t	*	maxArbitraryWaveformSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSigGenSoftwareControl)
+	(
+		int16_t												handle,
+		int16_t												state
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEts)
+  (
+		int16_t												handle,
+		PS4000A_ETS_MODE						mode,
+		int16_t												etsCycles,
+		int16_t												etsInterleave,
+		int32_t											* sampleTimePicoseconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelProperties)
+	(
+		int16_t																				handle,
+		PS4000A_TRIGGER_CHANNEL_PROPERTIES			 *	channelProperties,
+		int16_t																				nChannelProperties,
+		int16_t																				auxOutputEnable,
+		int32_t																				autoTriggerMilliseconds
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelConditions)
+	(
+		int16_t													handle,
+		PS4000A_CONDITION					*		conditions,
+		int16_t													nConditions,
+		PS4000A_CONDITIONS_INFO				info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerChannelDirections)
+	(
+		int16_t													handle,
+		PS4000A_DIRECTION					*		directions,
+		int16_t													nDirections
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetSimpleTrigger)
+	(
+		int16_t												handle,
+		int16_t												enable,
+		PS4000A_CHANNEL							source,
+		int16_t												threshold,
+		PS4000A_THRESHOLD_DIRECTION direction,
+		uint32_t								delay,
+		int16_t												autoTrigger_ms
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetTriggerDelay)
+	(
+		int16_t									handle,
+		uint32_t					delay
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetPulseWidthQualifierProperties)
+	(
+		int16_t														handle,
+		PS4000A_THRESHOLD_DIRECTION			direction,
+		uint32_t										lower,
+		uint32_t										upper,
+		PS4000A_PULSE_WIDTH_TYPE				type
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetPulseWidthQualifierConditions)
+	(
+		int16_t												handle,
+		PS4000A_CONDITION					*	conditions,
+		int16_t												nConditions,
+		PS4000A_CONDITIONS_INFO			info
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsTriggerOrPulseWidthQualifierEnabled)
+	(
+		int16_t 								handle,
+		int16_t 							* triggerEnabled,
+		int16_t 							* pulseWidthQualifierEnabled
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTriggerTimeOffset)
+	(
+		int16_t									handle,
+		uint32_t 			* timeUpper,
+		uint32_t 			* timeLower,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					segmentIndex
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetTriggerTimeOffset64)
+	(
+		int16_t									handle,
+		int64_t							* time,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t				segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesTriggerTimeOffsetBulk)
+	(
+	  int16_t									handle,
+		uint32_t				*	timesUpper,
+		uint32_t				* timesLower,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					fromSegmentIndex,
+		uint32_t					toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesTriggerTimeOffsetBulk64)
+	(
+	  int16_t									handle,
+		int64_t							*	times,
+		PS4000A_TIME_UNITS	*	timeUnits,
+		uint32_t					fromSegmentIndex,
+		uint32_t					toSegmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetDataBuffers)
+(
+   int16_t									handle,
+	 PS4000A_CHANNEL 				channel,
+	 int16_t								*	bufferMax,
+	 int16_t								*	bufferMin,
+   int32_t										bufferLth,
+	 uint32_t					segmentIndex,
+	 PS4000A_RATIO_MODE			mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetDataBuffer)
+(
+   int16_t								 handle,
+	 PS4000A_CHANNEL 			 channel,
+	 int16_t							*  buffer,
+   int32_t									 bufferLth,
+	 uint32_t				 segmentIndex,
+	 PS4000A_RATIO_MODE		 mode
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEtsTimeBuffer)
+(
+   int16_t									handle,
+	 int64_t *							buffer,
+	 int32_t										bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetEtsTimeBuffers)
+(
+   int16_t									handle,
+	 uint32_t				* timeUpper,
+	 uint32_t				* timeLower,
+	 int32_t										bufferLth
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aIsReady)
+	(
+		int16_t handle,
+		int16_t * ready
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aRunBlock)
+	(
+		int16_t									handle,
+		int32_t									noOfPreTriggerSamples,
+		int32_t									noOfPostTriggerSamples,
+		uint32_t					timebase,
+		int32_t								* timeIndisposedMs,
+		uint32_t					segmentIndex,
+		ps4000aBlockReady			lpReady,
+		void								* pParameter
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aRunStreaming)
+  (
+	  int16_t									handle,
+		uint32_t				* sampleInterval,
+		PS4000A_TIME_UNITS		sampleIntervalTimeUnits,
+	  uint32_t					maxPreTriggerSamples,
+	  uint32_t					maxPostTriggerSamples,
+		int16_t									autoStop,
+		uint32_t					downSampleRatio,
+		PS4000A_RATIO_MODE		downSampleRatioMode,
+    uint32_t					overviewBufferSize
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetStreamingLatestValues)
+  (
+    int16_t									handle,
+    ps4000aStreamingReady	lpPs4000aReady,
+		void								* pParameter
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aNoOfStreamingValues)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfValues
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetMaxDownSampleRatio)
+	(
+	  int16_t								handle,
+		uint32_t 			noOfUnaggregatedSamples,
+		uint32_t 		* maxDownSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValues)
+	(
+	  int16_t								handle,
+		uint32_t 			startIndex,
+	  uint32_t			*	noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex,
+		int16_t							* overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesAsync)
+	(
+	  int16_t								handle,
+		uint32_t				startIndex,
+	  uint32_t				noOfSamples,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE	downSampleRatioMode,
+		uint32_t				segmentIndex,
+	  void							*	lpDataReady,
+		void							*	pParameter
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesBulk)
+	(
+	  int16_t								handle,
+		uint32_t			*	noOfSamples,
+		uint32_t				fromSegmentIndex,
+		uint32_t				toSegmentIndex,
+	  uint32_t				downSampleRatio,
+		PS4000A_RATIO_MODE 	downSampleRatioMode,
+		int16_t							* overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesOverlapped)
+	(
+	  int16_t										handle,
+	  uint32_t			 			startIndex,
+	  uint32_t					*	noOfSamples,
+	  uint32_t						downSampleRatio,
+	  PS4000A_RATIO_MODE			downSampleRatioMode,
+		uint32_t						segmentIndex,
+	  int16_t									* overflow
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetValuesOverlappedBulk)
+	(
+	  int16_t									handle,
+		uint32_t					startIndex,
+  	uint32_t 	 		*	noOfSamples,
+	  uint32_t					downSampleRatio,
+	  PS4000A_RATIO_MODE		downSampleRatioMode,
+	  uint32_t					fromSegmentIndex,
+	  uint32_t					toSegmentIndex,
+	  int16_t								*	overflow
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aEnumerateUnits)
+	(
+	int16_t * count,
+	int8_t * serials,
+	int16_t * serialLth
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetChannelInformation)
+	(
+	int16_t										handle,
+	PS4000A_CHANNEL_INFO		info,
+	int32_t											probe,
+	int32_t										* ranges,
+	int32_t										* length,
+	int32_t											channels);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aConnectDetect)
+	(
+	int16_t		handle,
+	PS4000A_CONNECT_DETECT * sensor,
+	int16_t  nSensors
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeInteractionCallback)
+ (
+	int16_t		handle,
+	ps4000aProbeInteractions callback
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aCalibrateProbe)
+(
+	int16_t	handle,
+	PS4000A_CHANNEL channel,
+	int16_t * checkCalibrationRequired
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeLedColour)
+(
+	int16_t		handle,
+	PS4000A_PROBE_CHANNEL_LED_SETTING * settings,
+	uint16_t nSettings
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aRegisterProbeLedColour)
+(
+	int16_t		handle,
+	PICO_CONNECT_PROBE probe,
+	PS4000A_PROBE_CHANNEL_LED_SETTING * settings,
+	uint16_t nSettings
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetProbeLedDefaults)
+  (
+    int16_t handle,
+    int16_t enabled
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMaximumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aMinimumValue)
+	(
+	int16_t		handle,
+	int16_t * value
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetAnalogueOffset)
+	(
+	int16_t							handle,
+	PICO_CONNECT_PROBE_RANGE	range,
+	PS4000A_COUPLING		coupling,
+	float							* maximumOffset,
+	float							* minimumOffset
+	);
+
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetMaxSegments)
+	(
+	int16_t						handle,
+	uint32_t * maxSegments
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aChangePowerSource)
+	(
+	int16_t				handle,
+  PICO_STATUS powerState
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aCurrentPowerSource)
+	(
+	int16_t		handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aStop)
+	(
+	  int16_t handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aPingUnit)
+	(
+	  int16_t handle
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetNoOfCaptures)
+	(
+	int16_t					handle,
+	uint32_t nCaptures
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetNoOfCaptures)
+  (
+    int16_t                handle,
+    uint32_t               * nCaptures
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetNoOfProcessedCaptures)
+  (
+    int16_t                handle,
+    uint32_t               * nProcessedCaptures
+  );
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aDeviceMetaData)
+	(
+	int16_t										handle,
+	int8_t									*	settings,
+	int32_t									*	nSettingsLength,
+	PS4000A_META_TYPE					type,
+	PS4000A_META_OPERATION		operation,
+	PS4000A_META_FORMAT				format
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetString)
+	(
+	int16_t										handle,
+	PICO_STRING_VALUE					stringValue,
+	int8_t									*	string,
+	int32_t									*	stringLength
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aGetCommonModeOverflow)
+	(
+	int16_t			handle,
+	uint16_t	*	overflow
+	);
+PREF0 PREF1 PICO_STATUS PREF2 PREF3 (ps4000aSetFrequencyCounter)
+(
+    int16_t                                handle,
+    PS4000A_CHANNEL                        channel,
+    int16_t                                enabled,
+    PS4000A_FREQUENCY_COUNTER_RANGE        range,
+    int16_t                                thresholdMajor,
+    int16_t                                thresholdMinor
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aQueryOutputEdgeDetect)
+(
+	int16_t		handle,
+	int16_t * state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetOutputEdgeDetect)
+(
+	int16_t	handle,
+	int16_t state
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetDeviceResolution)
+(
+  int16_t                          handle,
+  PS4000A_DEVICE_RESOLUTION        resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetDeviceResolution)
+(
+	int16_t                      handle,
+	PS4000A_DEVICE_RESOLUTION    * resolution
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aSetCalibrationPins)
+(
+	int16_t               handle,
+	PS4000A_PIN_STATES		pinStates,
+	PS4000A_WAVE_TYPE			waveType,
+	double								frequency,
+	uint32_t							amplitude,
+	uint32_t							offset
+);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aNearestSampleIntervalStateless)
+(
+	int16_t                        handle,
+	PS4000A_CHANNEL_FLAGS          enabledChannelOrPortFlags,
+	double                         timeIntervalRequested,
+	PS4000A_DEVICE_RESOLUTION      resolution,
+	uint16_t                       useEts,
+	uint32_t                       * timebase,
+	double                         * timeIntervalAvailable
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aGetMinimumTimebaseStateless)
+(
+	int16_t                        handle,
+	PS4000A_CHANNEL_FLAGS          enabledChannelOrPortFlags,
+	uint32_t                       * timebase,
+	double                         * timeInterval,
+	PS4000A_DEVICE_RESOLUTION      resolution
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aCheckForUpdate)
+(
+	int16_t handle,
+	PICO_FIRMWARE_INFO* firmwareInfos,
+    int16_t* nFirmwareInfos,
+    uint16_t* updatesRequired
+	);
+
+PREF0 PREF1 PICO_STATUS PREF2 PREF3(ps4000aStartFirmwareUpdate)
+(
+	int16_t handle,
+	PicoUpdateFirmwareProgress progress
+	);
+
+#endif

+ 971 - 0
pico-tcp-service/pico-tcp/main.cpp

@@ -0,0 +1,971 @@
+#include <iostream>
+#include <memory>
+#include <windows.h>
+#include <tuple>
+#include "picofunctions.h"
+#include "pugiconfig.hpp"
+#include "pugixml.hpp"
+#include "simplelogger.hpp"
+#include "parser.hpp"
+#include "src/PassiveSocket.h"
+
+
+#define MAX_PACKET 4096
+using namespace std;
+
+extern ostream out(cout.rdbuf());
+extern SimpleLogger logger(out, "pico", "picologs");
+
+class PicoLocalService
+{
+private:
+    CActiveSocket* SocketActive;
+    const static uint8_t magic_number = 0xAA;
+    int16_t handle = 0;
+    uint8_t last_command = 0x00;
+    uint32_t error_code = 0x00000000;
+    int32_t points_value = 0;
+    uint32_t sample_rate = 0;
+    std::vector<uint32_t> times;
+    uint32_t number_channels = 0;
+    std::vector<PS4000A_CHANNEL> channels;
+    std::vector<uint32_t> points_vector;
+    PS4000A_CONDITION* conditions;
+    PS4000A_CHANNEL trig_channel = PS4000A_CHANNEL_A;
+    PS4000A_THRESHOLD_DIRECTION th_direction = PS4000A_ABOVE;
+    int16_t threshold = 0;
+    int16_t trig_delay = 0;
+    int16_t trig_autoTrigger_ms = 0;
+    uint32_t nbytes_sent = 0;
+    std::vector<std::vector<int16_t*>> data_buffer_vec;
+
+    uint8_t rcbuf[MAX_PACKET]{0};
+    uint8_t sndbuf[MAX_PACKET]{0};
+public:
+    PicoLocalService(CActiveSocket* socket) : SocketActive(socket) {}
+    ~PicoLocalService() {}
+
+
+
+    int get_request() {
+        // Check if buffer has at least 2 bytes for magic number and command
+        // Receive data from socket
+        int bytes_recieved = SocketActive->Receive(MAX_PACKET, rcbuf);
+
+        if(bytes_recieved == 0)
+        {
+            logger << LogPref::Flag(ERROR) << "Client disconnected" << endl;
+            pico_stop();
+            pico_close();
+            return 0;
+        }
+
+
+        if(bytes_recieved < 2)
+        {
+            logger << LogPref::Flag(ERROR) << "Invalid buffer size" << endl;
+            sndbuf[0] = magic_number;
+            sndbuf[1] = 0xFF; // Error flag
+            sndbuf[2] = 0x01; // Error type
+            this->error_code = 0x00000000; // No pico error
+            memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+            if(SocketActive->Send(sndbuf, 7) == -1) {
+                logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            }
+            return -1;
+        }
+
+        // Extract magic number from buffer
+        uint8_t magic;
+        memcpy(&magic, rcbuf, sizeof(uint8_t));
+
+        // Check if magic number is correct
+        if (magic != this->magic_number) {
+            logger << LogPref::Flag(ERROR) << "Invalid magic number: " << std::hex << magic << endl;
+            sndbuf[0] = magic_number;
+            sndbuf[1] = 0xFF;
+            sndbuf[2] = 0x03;
+            this->error_code = 0x00000000;
+            memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+            if(SocketActive->Send(sndbuf, 7) == -1) {
+                logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            }
+            return -1;
+        }
+
+        // Extract command from buffer
+        uint8_t cmd;
+        memcpy(&cmd, rcbuf + 1, sizeof(uint8_t));
+
+        // Check if command is correct
+        switch(cmd)
+        {
+            case 0x01:
+            {
+                this->last_command = 0x01;
+                logger << LogPref::Flag(INFO) << "Command 0x01 received" << endl;
+                pico_open();
+                logger << LogPref::Flag(INFO) << "Pico device opened" << endl;
+                break;
+            }
+            case 0x02:
+            {
+                this->last_command = 0x02;
+                logger << LogPref::Flag(INFO) << "Command 0x02 received" << endl;
+                if(bytes_recieved < 7) {
+                    logger << LogPref::Flag(ERROR) << "Invalid buffer size" << endl;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x01;
+                    this->error_code = 0x00000000;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+                uint32_t size;
+                memcpy(&size, rcbuf + 2, sizeof(uint32_t));
+                if(size < 1) {
+                    logger << LogPref::Flag(ERROR) << "Invalid data size" << endl;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x02;
+                    this->error_code = 0x00000000;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+                char* file_name = new char[size + 1];
+                memcpy(file_name, rcbuf + 6, size * sizeof(char));
+                file_name[size] = '\0'; // Null-terminate the string
+                std::string file_name_str(file_name);
+                logger << LogPref::Flag(INFO) << "File name: " << file_name_str << endl;
+                pico_xml_config(file_name_str);
+                logger << LogPref::Flag(INFO) << "Pico device configured" << endl;
+                delete[] file_name;
+                break;
+            }
+            case 0x0C:
+            {
+                this->last_command = 0x0C;
+                logger << LogPref::Flag(INFO) << "Command 0x0C received" << endl;
+                if(bytes_recieved < 22) {
+                    logger << LogPref::Flag(ERROR) << "Invalid buffer size" << endl;
+                    return -1;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x01;
+                    this->error_code = 0x00000000;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+                uint32_t size;
+                memcpy(&size, rcbuf + 2, sizeof(uint32_t));
+                if(size < 1) {
+                    logger << LogPref::Flag(ERROR) << "Invalid data size" << endl;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x02;
+                    this->error_code = 0x00000000;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+                uint32_t* apoints = new uint32_t[size];
+                memcpy(apoints, rcbuf + 6, size * sizeof(uint32_t));
+                uint32_t* atimes = new uint32_t[size];
+                memcpy(atimes, rcbuf + 6 + size * sizeof(uint32_t), size * sizeof(uint32_t));
+                uint32_t sample_rate = 0;
+                memcpy(&sample_rate, rcbuf + 6 + 2 * size * sizeof(uint32_t), sizeof(uint32_t));
+                uint32_t number_channels = 0;
+                memcpy(&number_channels, rcbuf + 10 + 2 * size * sizeof(uint32_t), sizeof(uint32_t));
+                pico_set_params(apoints, atimes, sample_rate, number_channels, size);
+                logger << LogPref::Flag(INFO) << "Pico device parameters set" << endl;
+                delete[] apoints;
+                delete[] atimes;
+                break;
+            }
+            case 0x03:
+            {
+                this->last_command = 0x03;
+                logger << LogPref::Flag(INFO) << "Command 0x03 received" << endl;
+                pico_close();
+                logger << LogPref::Flag(INFO) << "Pico device closed" << endl;
+                break;
+            }
+            case 0x04:
+            {
+                // Check if buffer has enough data for version numbers
+                this->last_command = 0x04;
+                logger << LogPref::Flag(INFO) << "Command 0x04 received" << endl;
+                pico_get_current_params();
+                logger << LogPref::Flag(INFO) << "Pico device parameters retrieved" << endl;
+                break;
+            }
+            case 0x05:
+            {
+                this->last_command = 0x05;
+                logger << LogPref::Flag(INFO) << "Command 0x05 received" << endl;
+                pico_probe();
+                logger << LogPref::Flag(INFO) << "Pico device probed" << endl;
+                break;
+            }
+            case 0x06:
+            {
+                this->last_command = 0x06;
+                logger << LogPref::Flag(INFO) << "Command 0x06 received" << endl;
+                if(bytes_recieved < 10) {
+                    logger << LogPref::Flag(ERROR) << "Invalid buffer size" << endl;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x01;
+                    this->error_code = 0x00000000;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+                uint32_t size;
+                memcpy(&size, rcbuf + 2, sizeof(uint32_t));
+                if(size < 1) {
+                    logger << LogPref::Flag(ERROR) << "Invalid data size" << endl;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x02;
+                    this->error_code = 0x00000000;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+                uint32_t* apoints = new uint32_t[size];
+                memcpy(apoints, rcbuf + 6, size * sizeof(uint32_t));
+                pico_set_points(apoints, size);
+                logger << LogPref::Flag(INFO) << "Pico device points set" << endl;
+                delete[] apoints;
+                break;
+            }
+            case 0x07:
+            {
+                this->last_command = 0x07;
+                logger << LogPref::Flag(INFO) << "Command 0x07 received" << endl;
+                if(bytes_recieved < 6) {
+                    logger << LogPref::Flag(ERROR) << "Invalid buffer size" << endl;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x01;
+                    this->error_code = 0x00000000;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+                uint32_t sample_rate = 0;
+                memcpy(&sample_rate, rcbuf + 2, sizeof(uint32_t));
+                pico_set_sample_rate(sample_rate);
+                logger << LogPref::Flag(INFO) << "Pico device sample rate set" << endl;
+                break;
+            }
+            case 0x08:
+            {
+                this->last_command = 0x08;
+                logger << LogPref::Flag(INFO) << "Command 0x08 received" << endl;
+                if(bytes_recieved < 10) {
+                    logger << LogPref::Flag(ERROR) << "Invalid buffer size" << endl;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x01;
+                    this->error_code = 0x00000000;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+                uint32_t size;
+                memcpy(&size, rcbuf + 2, sizeof(uint32_t));
+                if(size < 1) {
+                    logger << LogPref::Flag(ERROR) << "Invalid data size" << endl;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x02;
+                    this->error_code = 0x00000000;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+                uint32_t* atimes = new uint32_t[size];
+                memcpy(atimes, rcbuf + 6, size * sizeof(uint32_t));
+                pico_set_times(atimes, size);
+                logger << LogPref::Flag(INFO) << "Pico device times set" << endl;
+                delete[] atimes;
+                break;
+            }
+            case 0x09:
+            {
+                this->last_command = 0x09;
+                logger << LogPref::Flag(INFO) << "Command 0x09 received" << endl;
+                if(bytes_recieved < 15) {
+                    logger << LogPref::Flag(ERROR) << "Invalid buffer size" << endl;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x01;
+                    this->error_code = 0x00000000;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+                uint32_t channels = 0;
+                memcpy(&channels, rcbuf + 2, sizeof(uint32_t));
+                uint8_t trigger_channel = 0;
+                memcpy(&trigger_channel, rcbuf + 6, sizeof(uint8_t));
+                int32_t direction = 0;
+                memcpy(&direction, rcbuf + 7, sizeof(int32_t));
+                uint16_t threshold = 0;
+                memcpy(&threshold, rcbuf + 11, sizeof(uint16_t));
+                int16_t autoTrigger_ms = 0;
+                memcpy(&autoTrigger_ms, rcbuf + 13, sizeof(int16_t));
+                pico_configure_channels(channels, trigger_channel, direction, threshold, autoTrigger_ms);
+                logger << LogPref::Flag(INFO) << "Pico device channels configured" << endl;
+                break;
+            }
+            case 0x0A:
+            {
+                this->last_command = 0x0A;
+                logger << LogPref::Flag(INFO) << "Command 0x0A received" << endl;
+                pico_begin_measurement();
+                logger << LogPref::Flag(INFO) << "Pico device measurement started" << endl;
+                break;
+            }
+            case 0x0D:
+            {
+                this->last_command = 0x0D;
+                logger << LogPref::Flag(INFO) << "Command 0x0B received" << endl;
+                int ret = pico_exit();
+                if(ret == 0) {
+                    logger << LogPref::Flag(INFO) << "Pico device exited successfully" << endl;
+                    return 0;
+                } else {
+                    logger << LogPref::Flag(ERROR) << "Failed to exit Pico device" << endl;
+                }
+                break;
+            }
+            case 0x0E:
+            {
+                this->last_command = 0x0E;
+                logger << LogPref::Flag(INFO) << "Command 0x0E received" << endl;
+                pico_stop();
+                logger << LogPref::Flag(INFO) << "Pico device stopped" << endl;
+                break;
+            }
+            default:
+            {
+                this->last_command = 0xFF;
+                logger << LogPref::Flag(ERROR) << "Invalid command: " << std::hex << cmd << endl;
+                sndbuf[0] = magic_number;
+                sndbuf[1] = 0xFF;
+                sndbuf[2] = 0x00;
+                this->error_code = 0x00000000;
+                memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                if(SocketActive->Send(sndbuf, 7) == -1) {
+                    logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                }
+                return -1;
+            }
+        }
+
+        return 1;
+    }
+
+    int pico_open() {
+        // Open socket and initialize Pico device
+        auto retval = ps4000aOpenUnit(&handle, NULL);
+        logger << LogPref::Flag(INFO) << "Pico device opened with handle: " << handle << endl;
+        if (retval != 0) {
+            logger << LogPref::Flag(ERROR) << "Failed to open Pico device. Code: " << retval << endl;
+            sndbuf[0] = magic_number;
+            sndbuf[1] = 0xFF;
+            sndbuf[2] = 0x03;
+            this->error_code = retval;
+            memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+            if(SocketActive->Send(sndbuf, 7) == -1) {
+                logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            }
+            return -1;
+        }
+
+        int16_t start{10};
+        retval = ps4000aFlashLed(handle, start);
+        logger << LogPref::Flag(INFO) << "Pico device LED flashed." << endl;
+        if (retval != 0) {
+            logger << LogPref::Flag(ERROR) << "Failed to flash Pico device LED. Code: " << retval << endl;
+            sndbuf[0] = magic_number;
+            sndbuf[1] = 0xFF;
+            sndbuf[2] = 0x04;
+            this->error_code = retval;
+            memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+            if(SocketActive->Send(sndbuf, 7) == -1) {
+                logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            }
+            return -1;
+        }
+
+        logger << LogPref::Flag(INFO) << "Pico device LED flashed." << endl;
+
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xC1;
+
+        if(SocketActive->Send(sndbuf, 2) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+
+        logger << LogPref::Flag(INFO) << "Data sent to socket" << endl;
+
+        return 0;
+    }
+
+    int pico_stop()
+    {
+        // Stop measurement and close Pico device
+        auto retval = ps4000aStop(handle);
+        if (retval != 0) {
+            logger << LogPref::Flag(ERROR) << "Failed to stop Pico device. Code: " << retval << endl;
+            sndbuf[0] = magic_number;
+            sndbuf[1] = 0xFF;
+            sndbuf[2] = 0x06;
+            this->error_code = retval;
+            memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+            if(SocketActive->Send(sndbuf, 7) == -1) {
+                logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            }
+            return -1;
+        }
+        logger << LogPref::Flag(INFO) << "Pico device stopped" << endl;
+
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xCE;
+
+        if(SocketActive->Send(sndbuf, 2) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+        logger << LogPref::Flag(INFO) << "Data sent to socket" << endl;
+
+        return 0;
+    }
+
+    int pico_xml_config(const string& file_name) {
+        // Load configuration from XML file
+        auto data_set = parse_xml_function(file_name.c_str());
+        points_vector = string_to_vector(std::get<0>(data_set));
+        times = string_to_vector(std::get<2>(data_set));
+        points_value = *(std::max_element(points_vector.begin(), points_vector.end()));
+        number_channels = std::get<1>(data_set);
+        sample_rate = std::get<3>(data_set);
+
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xC2;
+
+        if(SocketActive->Send(sndbuf, 2) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+        logger << LogPref::Flag(INFO) << "Data sent to socket" << endl;
+
+        return 0;
+    }
+
+    int pico_set_params(const uint32_t* points, const uint32_t* times, const uint32_t sample_rate, const uint32_t number_channels, const uint32_t size) {
+        // Set parameters for measurement
+        this->points_vector.assign(points, points + size);
+        this->times.assign(times, times + size);
+        this->sample_rate = sample_rate;
+        this->number_channels = number_channels;
+        points_value = *(std::max_element(points_vector.begin(), points_vector.end()));
+        logger << LogPref::Flag(INFO) << "Parameters set" << endl;
+
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xCC;
+
+        if(SocketActive->Send(sndbuf, 2) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+
+        return 0;
+    }
+
+    int pico_close() {
+        // Close Pico device and socket
+        auto retval = ps4000aCloseUnit(handle);
+        if (retval != 0) {
+            logger << LogPref::Flag(ERROR) << "Failed to close Pico device. Code: " << retval << endl;
+            sndbuf[0] = magic_number;
+            sndbuf[1] = 0xFF;
+            sndbuf[2] = 0x05;
+            this->error_code = retval;
+            memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+            if(SocketActive->Send(sndbuf, 7) == -1) {
+                logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            }
+            return -1;
+        }
+        logger << LogPref::Flag(INFO) << "Pico device closed" << endl;
+
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xC3;
+        if(SocketActive->Send(sndbuf, 2) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+        logger << LogPref::Flag(INFO) << "Data sent to socket" << endl;
+
+        return 0;
+    }
+
+    int pico_get_current_params() {
+        // Get current parameters from Pico device
+        logger << LogPref::Flag(INFO) << "Current parameters:" << endl;
+
+        logger << "Points: " << points_value << endl;
+        logger << "Times size: " << times.size() << endl;
+        logger << "Sample rate: " << sample_rate << endl;
+        logger << "Number of channels: " << number_channels << endl;
+        logger << "Trigger channel: " << trig_channel << endl;
+        logger << "Trigger direction: " << th_direction << endl;
+
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xC4;
+        uint32_t bsize = points_vector.size() * sizeof(uint32_t);
+        uint32_t test = 0;
+
+        memcpy(sndbuf + 2, &bsize, sizeof(uint32_t));
+        memcpy(sndbuf + 6, points_vector.data(), bsize);
+        memcpy(&test, points_vector.data(), bsize);
+        logger << LogPref::Flag(INFO) << test << endl;
+        memcpy(sndbuf + 6 + bsize, times.data(), bsize);
+        logger << LogPref::Flag(INFO) << times.data()[0] << endl;
+        memcpy(sndbuf + 6 + 2 * bsize, &sample_rate, sizeof(sample_rate));
+        memcpy(sndbuf + 10 + 2 * bsize, &number_channels, sizeof(number_channels));
+
+        if(SocketActive->Send(sndbuf, 10 + sizeof(points_vector.data()) + sizeof(times.data())) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+
+        return 0;
+    }
+
+    int pico_probe() {
+        // Probe signal from Pico device
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xC5;
+
+        if(SocketActive->Send(sndbuf, 2) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+
+        logger << LogPref::Flag(INFO) << "Data sent to socket" << endl;
+
+        return 0;
+    }
+
+    int pico_set_points(const uint32_t* points, const uint32_t size) {
+        // Set points for measurement
+        this->points_vector.assign(points, points + size);
+        points_value = *(std::max_element(points_vector.begin(), points_vector.end()));
+        logger << LogPref::Flag(INFO) << "Points set" << endl;
+
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xC6;
+
+        if(SocketActive->Send(sndbuf, 2) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+
+        return 0;
+    }
+
+    int pico_set_sample_rate(const uint32_t sample_rate) {
+        // Set sample rate for measurement
+        this->sample_rate = sample_rate;
+        logger << LogPref::Flag(INFO) << "Sample rate set to: " << sample_rate << endl;
+
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xC7;
+
+        if(SocketActive->Send(sndbuf, 2) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+
+        return 0;
+    }
+
+    int pico_set_times(const uint32_t* times, const uint32_t size) {
+        // Set times for measurement
+        this->times.assign(times, times + size);
+        logger << LogPref::Flag(INFO) << "Times set" << endl;
+
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xC8;
+
+        if(SocketActive->Send(sndbuf, 2) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+
+        return 0;
+    }
+
+    int pico_configure_channels(const uint32_t number_channels, uint8_t trigger_channel, int32_t direction, uint16_t threshold, int16_t autoTrigger_ms) {
+        // Set number of channels for measurement
+        this->number_channels = number_channels;
+        logger << LogPref::Flag(INFO) << "Number of channels set to: " << number_channels << endl;
+
+        this->channels = create_channel(number_channels);
+        conditions = new PS4000A_CONDITION[number_channels];
+        for (uint32_t i = 0; i < number_channels; ++i) {
+            conditions[i].source = channels[i];
+            conditions[i].condition = PS4000A_CONDITION_FALSE;
+        }
+
+        if(auto retval = ps4000aSetChannel(handle, channels[trigger_channel], true, PS4000A_DC, PICO_X1_PROBE_5V, 0) != 0) {
+            logger << LogPref::Flag(ERROR) << "Failed to set trigger channel. Code: " << retval << endl;
+            sndbuf[0] = magic_number;
+            sndbuf[1] = 0xFF;
+            sndbuf[2] = 0x06;
+            this->error_code = retval;
+            memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+            if(SocketActive->Send(sndbuf, 7) == -1) {
+                logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            }
+            return -1;
+        }
+        logger << LogPref::Flag(INFO) << "Trigger channel set" << endl;
+
+        this->trig_channel = channels[trigger_channel];
+        this->th_direction = static_cast<PS4000A_THRESHOLD_DIRECTION>(direction);
+        this->threshold = threshold;
+        this->trig_delay = 10;
+        this->trig_autoTrigger_ms = autoTrigger_ms;
+
+        for(uint8_t i = 0; i < number_channels; ++i) {
+            if(i == trigger_channel) continue;
+            else {
+                auto retval = ps4000aSetChannel(handle, channels[i], true, PS4000A_AC, PICO_X1_PROBE_5V, 0);
+                if (retval != 0) {
+                    logger << LogPref::Flag(ERROR) << "Failed to set channel " << i << ". Code: " << retval << endl;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x07 + i;
+                    this->error_code = retval;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+                logger << LogPref::Flag(INFO) << "Channel " << i << " set" << endl;
+            }
+        }
+
+        auto retval = ps4000aSetSimpleTrigger
+        (
+         handle,
+         true,
+         conditions[trigger_channel].source,
+         threshold,
+         th_direction,
+         trig_delay,
+         trig_autoTrigger_ms
+        );
+
+        if (retval != 0) {
+            logger << LogPref::Flag(ERROR) << "Failed to set trigger. Code: " << retval << endl;
+            sndbuf[0] = magic_number;
+            sndbuf[1] = 0xFF;
+            sndbuf[2] = 0x12;
+            this->error_code = retval;
+            memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+            if(SocketActive->Send(sndbuf, 7) == -1) {
+                logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            }
+            return -1;
+        }
+
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xC9;
+
+        if(SocketActive->Send(sndbuf, 2) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+
+        return 0;
+    }
+
+    int pico_begin_measurement() {
+        // Begin measurement on Pico device
+
+        data_buffer_vec.assign(times.size(), std::vector<int16_t*>(number_channels, nullptr));
+
+        for(size_t i = 0; i < times.size(); ++i) {
+
+
+            logger << LogPref::Flag(INFO) << "Set data buffer:" << endl;
+
+            for(size_t j = 0; j < number_channels; ++j) {
+                data_buffer_vec[i][j] = new int16_t[points_vector[i]];
+            }
+
+            logger << LogPref::Flag(INFO) << "Get timebase:" << endl;
+            uint32_t timebase = timebase_choice(sample_rate);
+            logger << "Timebase = " << timebase << endl;
+
+
+            int32_t timeIntervalNanoseconds = 0;
+            int32_t maxSamples = 0;
+            int32_t segmentIndex = 0;
+
+            int32_t retval = ps4000aGetTimebase(handle, timebase, points_vector[i], &timeIntervalNanoseconds,
+                                                &maxSamples, segmentIndex);
+            logger << "retval: " << retval << endl;
+            if(retval != 0) {
+                logger << LogPref::Flag(ERROR) << "Failed to get timebase. Code: " << retval << endl;
+                sndbuf[0] = magic_number;
+                sndbuf[1] = 0xFF;
+                sndbuf[2] = 0x13;
+                this->error_code = retval;
+                memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                if(SocketActive->Send(sndbuf, 7) == -1) {
+                    logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                }
+                return -1;
+            }
+
+            logger << LogPref::Flag(INFO) << "Run block:" << endl;
+
+            int32_t noOfPreTriggerSamples = 0;
+            int32_t noOfPostTriggerSamples = points_value;
+
+            retval = ps4000aRunBlock(handle, noOfPreTriggerSamples, noOfPostTriggerSamples, timebase,
+                                      nullptr, segmentIndex, nullptr, nullptr);
+            logger << "retval: " << retval << endl;
+            if(retval != 0) {
+                logger << LogPref::Flag(ERROR) << "Failed to run block. Code: " << retval << endl;
+                sndbuf[0] = magic_number;
+                sndbuf[1] = 0xFF;
+                sndbuf[2] = 0x14;
+                this->error_code = retval;
+                memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                if(SocketActive->Send(sndbuf, 7) == -1) {
+                    logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                }
+                return -1;
+            }
+            logger << LogPref::Flag(INFO) << "Run block done" << endl;
+
+            int16_t ready = 0;
+            while (ready == 0) {
+                retval = ps4000aIsReady(handle, &ready);
+            }
+
+            for(uint8_t j = 0; j < number_channels; ++j) {
+                logger << LogPref::Flag(INFO) << "Set data buffer for channel " << j << endl;
+                PS4000A_RATIO_MODE mode = PS4000A_RATIO_MODE_NONE;
+                retval = ps4000aSetDataBuffer(handle, channels[j], data_buffer_vec[i][j], points_vector[i],
+                                              segmentIndex, mode);
+                logger << "retval: " << retval << endl;
+                if(retval != 0) {
+                    logger << LogPref::Flag(ERROR) << "Failed to set data buffer for channel " << j << ". Code: " << retval << endl;
+                    sndbuf[0] = magic_number;
+                    sndbuf[1] = 0xFF;
+                    sndbuf[2] = 0x15 + j;
+                    this->error_code = retval;
+                    memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                    if(SocketActive->Send(sndbuf, 7) == -1) {
+                        logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                    }
+                    return -1;
+                }
+            }
+
+            logger << LogPref::Flag(INFO) << "Set data buffer done" << endl;
+
+            logger << LogPref::Flag(INFO) << "Data collection start" << endl;
+            uint32_t StartIndex = 0;
+            uint32_t noOfSamples = static_cast<uint32_t>(points_vector[i]);
+            int16_t overflow = 0;
+            uint32_t DownSampleRatio = 1;
+
+            retval = ps4000aGetValues(handle, StartIndex, &noOfSamples, DownSampleRatio, PS4000A_RATIO_MODE_NONE,
+                                        segmentIndex, &overflow);
+            logger << "retval: " << retval << endl;
+            if(retval != 0) {
+                logger << LogPref::Flag(ERROR) << "Failed to get values. Code: " << retval << endl;
+                sndbuf[0] = magic_number;
+                sndbuf[1] = 0xFF;
+                sndbuf[2] = 0x21;
+                this->error_code = retval;
+                memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                if(SocketActive->Send(sndbuf, 7) == -1) {
+                    logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                }
+                return -1;
+            }
+            logger << LogPref::Flag(INFO) << "Data collection done" << endl;
+
+            logger << LogPref::Flag(INFO) << "Confirm data to socket" << endl;
+            sndbuf[0] = magic_number;
+            sndbuf[1] = 0xCA;
+            if(SocketActive->Send(sndbuf, 2) == -1) {
+                logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                return -1;
+            }
+            logger << LogPref::Flag(INFO) << "Data sent to socket" << endl;
+
+            logger << LogPref::Flag(INFO) << "Data confirmed" << endl;
+            logger << LogPref::Flag(INFO) << "Sleeping for " << times[i+1] - times[i] << " ms" << endl;
+            if(i < times.size() - 1) {
+                std::chrono::duration<int64, std::milli> duration(times[i+1] - times[i]);
+                std::this_thread::sleep_for(duration);
+            }
+        }
+
+        for(int i = 0; i < data_buffer_vec.size(); ++i) {
+            logger << LogPref::Flag(INFO) << "Writing data " << i << " to file" << endl;
+            std::string filename = "data" + std::to_string(i) + ".csv";
+            writing_data_fixed_name(filename, data_buffer_vec[i], points_vector[i], number_channels);
+            logger << LogPref::Flag(INFO) << "Data collection done" << endl;
+            logger << LogPref::Flag(INFO) << "Free buffers? Why?" << endl;
+            free_buffers(data_buffer_vec[i]);
+            logger << LogPref::Flag(INFO) << "Buffers freed" << endl;
+        }
+
+        logger << LogPref::Flag(INFO) << "Measurement done" << endl;
+        sndbuf[0] = magic_number;
+        sndbuf[1] = 0xCB;
+
+        if (SocketActive->Send(sndbuf, 2) == -1) {
+            logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+            return -1;
+        }
+
+
+
+        logger << LogPref::Flag(INFO) << "Data sent to socket" << endl;
+
+        return 0;
+    }
+
+    int pico_exit() {
+        // Exit Pico device and free resources
+        if (handle != NULL) {
+            auto ret = ps4000aCloseUnit(handle);
+            if (ret != 0) {
+                logger << LogPref::Flag(ERROR) << "Failed to close Pico device. Code: " << ret << endl;
+                sndbuf[0] = magic_number;
+                sndbuf[1] = 0xFF;
+                sndbuf[2] = 0x23;
+                this->error_code = ret;
+                memcpy(sndbuf + 3, &this->error_code, sizeof(uint32_t));
+                if(SocketActive->Send(sndbuf, 7) == -1) {
+                    logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                }
+                return -1;
+            }
+
+            sndbuf[0] = magic_number;
+            sndbuf[1] = 0xCD;
+            if(SocketActive->Send(sndbuf, 2) == -1) {
+                logger << LogPref::Flag(ERROR) << "Failed to send data to socket" << endl;
+                return -1;
+            }
+
+            logger << LogPref::Flag(INFO) << "Pico device closed" << endl;
+            handle = NULL;
+        }
+
+        return 0;
+    }
+};
+
+int main()
+{
+    logger.enableConsoleOutput(true);
+
+    logger << "Open socket" << endl;
+    CPassiveSocket SocketPassive(CSimpleSocket::CSocketType::SocketTypeTcp);
+    if (!SocketPassive.Initialize())
+    {
+        logger << LogPref::Flag(ERROR) << "Socket initialization failed" << endl;
+        return -1;
+    }
+    if(!SocketPassive.Listen("127.0.0.1", 5003))
+    {
+        logger << LogPref::Flag(ERROR) << "Socket listening failed" << endl;
+        return -1;
+    }
+
+    logger << "Socket initialized!" << endl;
+
+    CActiveSocket* ClientSocket;
+    PicoLocalService* pico_service;
+
+    while(true)
+    {
+        logger << LogPref::Flag(INFO) << "Wait for connection..." << endl;
+        logger.closeLogger();
+
+        if ((ClientSocket = SocketPassive.Accept()) == nullptr)
+        {
+            logger.closeLogger();
+            logger.initializeLogger("picologs", "pico");
+            logger.enableConsoleOutput(true);
+            logger << LogPref::Flag(ERROR) << "Socket accept failed" << endl;
+            logger.closeLogger();
+            return -1;
+        }
+
+        logger.initializeLogger("picologs", "pico");
+        logger.enableConsoleOutput(true);
+
+        logger << LogPref::Flag(INFO) << "Client connected" << endl;
+        pico_service = new PicoLocalService(ClientSocket);
+
+        while(pico_service->get_request() != 0)
+        {
+            logger << LogPref::Flag(INFO) << "Request received" << endl;
+        }
+
+        logger << LogPref::Flag(INFO) << "Request processing finished" << endl;
+        delete pico_service;
+        pico_service = nullptr;
+
+        delete ClientSocket;
+        ClientSocket = nullptr;
+    }
+
+    return 0;
+}
+
+

BIN
pico-tcp-service/pico-tcp/obj/Debug/main.o


BIN
pico-tcp-service/pico-tcp/obj/Debug/parser.o


BIN
pico-tcp-service/pico-tcp/obj/Debug/picofunctions.o


BIN
pico-tcp-service/pico-tcp/obj/Debug/pugixml.o


BIN
pico-tcp-service/pico-tcp/obj/Debug/simplelogger.o


BIN
pico-tcp-service/pico-tcp/obj/Debug/src/ActiveSocket.o


BIN
pico-tcp-service/pico-tcp/obj/Debug/src/PassiveSocket.o


BIN
pico-tcp-service/pico-tcp/obj/Debug/src/SimpleSocket.o


BIN
pico-tcp-service/pico-tcp/obj/Debug/src/simplelogger.o


+ 26 - 0
pico-tcp-service/pico-tcp/parser.cpp

@@ -0,0 +1,26 @@
+#include "parser.hpp"
+
+Parser::Parser (int argc, char** argv) {
+    for(int i = 0; i < argc; i++) {
+        flags.push_back(argv[i]);
+    }
+
+}
+
+bool Parser::cmdOption (const std::string& option) {
+    return std::find(flags.begin(), flags.end(), option) != flags.end();
+}
+
+const std::string& Parser::setFilename(const std::string& option, const int32_t points, const uint32_t number_channels, const uint32_t freq) {
+    if(cmdOption(option)) {
+        auto it = std::find(flags.begin(), flags.end(), option) - flags.begin();
+        if(it - 1 == flags.size()) {
+            return std::to_string(points) + std::to_string(number_channels) + std::to_string(freq);
+        }
+        else {
+            return flags[it + 1];
+        }
+    }
+
+}
+

+ 16 - 0
pico-tcp-service/pico-tcp/parser.hpp

@@ -0,0 +1,16 @@
+#pragma once
+#include <vector>
+#include <string>
+#include <algorithm>
+class Parser {
+public:
+    Parser(int argc, char** argv);
+    ~Parser() = default;
+
+    bool cmdOption(const std::string& option);
+   const std::string& setFilename(const std::string& option, const int32_t points, const uint32_t number_channels, const uint32_t freq) ;
+
+
+private:
+        std::vector<std::string> flags;
+};

+ 82 - 0
pico-tcp-service/pico-tcp/pico-tcp.cbp

@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
+<CodeBlocks_project_file>
+	<FileVersion major="1" minor="6" />
+	<Project>
+		<Option title="pico-tcp" />
+		<Option pch_mode="2" />
+		<Option compiler="gcc" />
+		<Build>
+			<Target title="Debug">
+				<Option output="bin/Debug/pico-tcp" prefix_auto="1" extension_auto="1" />
+				<Option object_output="obj/Debug/" />
+				<Option type="1" />
+				<Option compiler="gcc" />
+				<Compiler>
+					<Add option="-g" />
+				</Compiler>
+				<Linker>
+					<Add option="-lws2_32" />
+				</Linker>
+			</Target>
+			<Target title="Release">
+				<Option output="bin/Release/pico-tcp" prefix_auto="1" extension_auto="1" />
+				<Option object_output="obj/Release/" />
+				<Option type="1" />
+				<Option compiler="gcc" />
+				<Compiler>
+					<Add option="-O2" />
+				</Compiler>
+				<Linker>
+					<Add option="-s" />
+				</Linker>
+			</Target>
+		</Build>
+		<Compiler>
+			<Add option="-Wall" />
+			<Add option="-fexceptions" />
+		</Compiler>
+		<Unit filename="inc/HRDL.h" />
+		<Unit filename="inc/PicoCallback.h" />
+		<Unit filename="inc/PicoConnectProbes.h" />
+		<Unit filename="inc/PicoDeviceDefinitionsExperimental.h" />
+		<Unit filename="inc/PicoDeviceEnums.h" />
+		<Unit filename="inc/PicoDeviceStructs.h" />
+		<Unit filename="inc/PicoStatus.h" />
+		<Unit filename="inc/PicoVersion.h" />
+		<Unit filename="inc/pl1000Api.h" />
+		<Unit filename="inc/plcm3Api.h" />
+		<Unit filename="inc/ps2000.h" />
+		<Unit filename="inc/ps2000aApi.h" />
+		<Unit filename="inc/ps3000.h" />
+		<Unit filename="inc/ps3000aApi.h" />
+		<Unit filename="inc/ps4000Api.h" />
+		<Unit filename="inc/ps4000aApi.h" />
+		<Unit filename="inc/ps5000Api.h" />
+		<Unit filename="inc/ps5000aApi.h" />
+		<Unit filename="inc/ps6000Api.h" />
+		<Unit filename="inc/ps6000aApi.h" />
+		<Unit filename="inc/ps6000aApiExperimental.h" />
+		<Unit filename="inc/usbDrDaqApi.h" />
+		<Unit filename="inc/usbPT104Api.h" />
+		<Unit filename="inc/usbtc08.h" />
+		<Unit filename="libps4000a/PicoStatus.h" />
+		<Unit filename="libps4000a/ps4000aApi.h" />
+		<Unit filename="main.cpp" />
+		<Unit filename="parser.cpp" />
+		<Unit filename="picofunctions.cpp" />
+		<Unit filename="pugixml.cpp" />
+		<Unit filename="simplelogger.cpp" />
+		<Unit filename="simplelogger.hpp" />
+		<Unit filename="src/ActiveSocket.cpp" />
+		<Unit filename="src/ActiveSocket.h" />
+		<Unit filename="src/Host.h" />
+		<Unit filename="src/PassiveSocket.cpp" />
+		<Unit filename="src/PassiveSocket.h" />
+		<Unit filename="src/SimpleSocket.cpp" />
+		<Unit filename="src/SimpleSocket.h" />
+		<Unit filename="src/StatTimer.h" />
+		<Extensions>
+			<lib_finder disable_auto="1" />
+		</Extensions>
+	</Project>
+</CodeBlocks_project_file>

+ 374 - 0
pico-tcp-service/pico-tcp/pico-tcp.depend

@@ -0,0 +1,374 @@
+# depslib dependency file v1.0
+1732277880 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\parser.cpp
+	"parser.hpp"
+
+1732277792 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\parser.hpp
+	<vector>
+	<string>
+	<algorithm>
+
+1745399888 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\picofunctions.cpp
+	"picofunctions.h"
+
+1745428916 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\picofunctions.h
+	<stdio.h>
+	<algorithm>
+	<chrono>
+	<fstream>
+	<iomanip>
+	<iostream>
+	<thread>
+	<tuple>
+	<vector>
+	"pugixml.hpp"
+	<conio.h>
+	"windows.h"
+	<stdio.h>
+	<chrono>
+	<cstring>
+	<thread>
+	"libps4000a/PicoStatus.h"
+	"libps4000a/ps4000aApi.h"
+	"pugiconfig.hpp"
+	"pugixml.hpp"
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\pugixml.hpp
+	"pugiconfig.hpp"
+	<stddef.h>
+	<exception>
+	<iterator>
+	<iosfwd>
+	<string>
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\pugiconfig.hpp
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\libps4000a\picostatus.h
+	<stdint.h>
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\libps4000a\ps4000aapi.h
+	<stdint.h>
+	"PicoStatus.h"
+	"../inc/PicoCallback.h"
+	"../inc/PicoConnectProbes.h"
+	"../inc/PicoVersion.h"
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picocallback.h
+	<stdint.h>
+	"PicoDeviceEnums.h"
+	"PicoDeviceStructs.h"
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picodeviceenums.h
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picodevicestructs.h
+	<stdint.h>
+	"PicoConnectProbes.h"
+	"PicoDeviceEnums.h"
+	"PicoStatus.h"
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picoconnectprobes.h
+	<stdint.h>
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picostatus.h
+	<stdint.h>
+
+1732145702 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\inc\picoversion.h
+	<stdint.h>
+	"PicoStatus.h"
+
+1732145702 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\pugixml.cpp
+	"pugixml.hpp"
+	<stdlib.h>
+	<stdio.h>
+	<string.h>
+	<assert.h>
+	<limits.h>
+	<wchar.h>
+	<math.h>
+	<float.h>
+	<istream>
+	<ostream>
+	<string>
+	<new>
+	<sys/stat.h>
+	<stdint.h>
+
+1741610104 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\activesocket.cpp
+	"ActiveSocket.h"
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\activesocket.h
+	"SimpleSocket.h"
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\simplesocket.h
+	<sys/stat.h>
+	<stdlib.h>
+	<stdio.h>
+	<stdarg.h>
+	<errno.h>
+	<sys/socket.h>
+	<netinet/in.h>
+	<arpa/inet.h>
+	<netinet/tcp.h>
+	<netinet/ip.h>
+	<netdb.h>
+	<linux/if_packet.h>
+	<linux/if_ether.h>
+	<linux/if.h>
+	<sys/sendfile.h>
+	<net/if.h>
+	<sys/time.h>
+	<sys/uio.h>
+	<unistd.h>
+	<fcntl.h>
+	<io.h>
+	<winsock2.h>
+	<ws2tcpip.h>
+	"Host.h"
+	"StatTimer.h"
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\host.h
+	<limits.h>
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\stattimer.h
+	<string.h>
+	<Winsock2.h>
+	<time.h>
+	<stdio.h>
+	<sys/time.h>
+	"Host.h"
+
+1741610104 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\passivesocket.cpp
+	"PassiveSocket.h"
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\passivesocket.h
+	"ActiveSocket.h"
+
+1741610104 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\simplelogger.cpp
+	"simplelogger.hpp"
+
+1741610104 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\simplelogger.hpp
+	<iostream>
+	<iomanip>
+	<chrono>
+	<ctime>
+	<sstream>
+	<fstream>
+	<sstream>
+	<fstream>
+
+1741610104 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\src\simplesocket.cpp
+	"SimpleSocket.h"
+
+1745429820 source:e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\main.cpp
+	<iostream>
+	<memory>
+	<windows.h>
+	<tuple>
+	"picofunctions.h"
+	"pugiconfig.hpp"
+	"pugixml.hpp"
+	"simplelogger.hpp"
+	"parser.hpp"
+	"src/PassiveSocket.h"
+
+1736707942 e:\lowfield_mri_programs\pico-tcp-service\pico-tcp\simplelogger.hpp
+	<iostream>
+	<iomanip>
+	<chrono>
+	<ctime>
+	<sstream>
+	<fstream>
+	<sstream>
+	<fstream>
+	<windows.h>
+	<winbase.h>
+	<sys/stat.h>
+	<unistd.h>
+
+1745850220 source:c:\lf_mri\pico-tcp-service\pico-tcp\main.cpp
+	<iostream>
+	<memory>
+	<windows.h>
+	<tuple>
+	"picofunctions.h"
+	"pugiconfig.hpp"
+	"pugixml.hpp"
+	"simplelogger.hpp"
+	"parser.hpp"
+	"src/PassiveSocket.h"
+
+1745428916 c:\lf_mri\pico-tcp-service\pico-tcp\picofunctions.h
+	<stdio.h>
+	<algorithm>
+	<chrono>
+	<fstream>
+	<iomanip>
+	<iostream>
+	<thread>
+	<tuple>
+	<vector>
+	"pugixml.hpp"
+	<conio.h>
+	"windows.h"
+	<stdio.h>
+	<chrono>
+	<cstring>
+	<thread>
+	"libps4000a/PicoStatus.h"
+	"libps4000a/ps4000aApi.h"
+	"pugiconfig.hpp"
+	"pugixml.hpp"
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp\pugixml.hpp
+	"pugiconfig.hpp"
+	<stddef.h>
+	<exception>
+	<iterator>
+	<iosfwd>
+	<string>
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp\pugiconfig.hpp
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp\libps4000a\picostatus.h
+	<stdint.h>
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp\libps4000a\ps4000aapi.h
+	<stdint.h>
+	"PicoStatus.h"
+	"../inc/PicoCallback.h"
+	"../inc/PicoConnectProbes.h"
+	"../inc/PicoVersion.h"
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp\inc\picocallback.h
+	<stdint.h>
+	"PicoDeviceEnums.h"
+	"PicoDeviceStructs.h"
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp\inc\picodeviceenums.h
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp\inc\picodevicestructs.h
+	<stdint.h>
+	"PicoConnectProbes.h"
+	"PicoDeviceEnums.h"
+	"PicoStatus.h"
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp\inc\picoconnectprobes.h
+	<stdint.h>
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp\inc\picostatus.h
+	<stdint.h>
+
+1732145702 c:\lf_mri\pico-tcp-service\pico-tcp\inc\picoversion.h
+	<stdint.h>
+	"PicoStatus.h"
+
+1736707942 c:\lf_mri\pico-tcp-service\pico-tcp\simplelogger.hpp
+	<iostream>
+	<iomanip>
+	<chrono>
+	<ctime>
+	<sstream>
+	<fstream>
+	<sstream>
+	<fstream>
+	<windows.h>
+	<winbase.h>
+	<sys/stat.h>
+	<unistd.h>
+
+1732277792 c:\lf_mri\pico-tcp-service\pico-tcp\parser.hpp
+	<vector>
+	<string>
+	<algorithm>
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp\src\passivesocket.h
+	"ActiveSocket.h"
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp\src\activesocket.h
+	"SimpleSocket.h"
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp\src\simplesocket.h
+	<sys/stat.h>
+	<stdlib.h>
+	<stdio.h>
+	<stdarg.h>
+	<errno.h>
+	<sys/socket.h>
+	<netinet/in.h>
+	<arpa/inet.h>
+	<netinet/tcp.h>
+	<netinet/ip.h>
+	<netdb.h>
+	<linux/if_packet.h>
+	<linux/if_ether.h>
+	<linux/if.h>
+	<sys/sendfile.h>
+	<net/if.h>
+	<sys/time.h>
+	<sys/uio.h>
+	<unistd.h>
+	<fcntl.h>
+	<io.h>
+	<winsock2.h>
+	<ws2tcpip.h>
+	"Host.h"
+	"StatTimer.h"
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp\src\host.h
+	<limits.h>
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp\src\stattimer.h
+	<string.h>
+	<Winsock2.h>
+	<time.h>
+	<stdio.h>
+	<sys/time.h>
+	"Host.h"
+
+1732277880 source:c:\lf_mri\pico-tcp-service\pico-tcp\parser.cpp
+	"parser.hpp"
+
+1745399888 source:c:\lf_mri\pico-tcp-service\pico-tcp\picofunctions.cpp
+	"picofunctions.h"
+
+1732145702 source:c:\lf_mri\pico-tcp-service\pico-tcp\pugixml.cpp
+	"pugixml.hpp"
+	<stdlib.h>
+	<stdio.h>
+	<string.h>
+	<assert.h>
+	<limits.h>
+	<wchar.h>
+	<math.h>
+	<float.h>
+	<istream>
+	<ostream>
+	<string>
+	<new>
+	<sys/stat.h>
+	<stdint.h>
+
+1741610104 source:c:\lf_mri\pico-tcp-service\pico-tcp\src\activesocket.cpp
+	"ActiveSocket.h"
+
+1741610104 source:c:\lf_mri\pico-tcp-service\pico-tcp\src\passivesocket.cpp
+	"PassiveSocket.h"
+
+1741610104 source:c:\lf_mri\pico-tcp-service\pico-tcp\src\simplelogger.cpp
+	"simplelogger.hpp"
+
+1741610104 c:\lf_mri\pico-tcp-service\pico-tcp\src\simplelogger.hpp
+	<iostream>
+	<iomanip>
+	<chrono>
+	<ctime>
+	<sstream>
+	<fstream>
+	<sstream>
+	<fstream>
+
+1741610104 source:c:\lf_mri\pico-tcp-service\pico-tcp\src\simplesocket.cpp
+	"SimpleSocket.h"
+
+1736725608 source:c:\lf_mri\pico-tcp-service\pico-tcp\simplelogger.cpp
+	"simplelogger.hpp"
+

BIN
pico-tcp-service/pico-tcp/pico-tcp.exe


+ 20 - 0
pico-tcp-service/pico-tcp/pico-tcp.layout

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
+<CodeBlocks_layout_file>
+	<FileVersion major="1" minor="0" />
+	<ActiveTarget name="Debug" />
+	<File name="main.cpp" open="1" top="0" tabpos="1" split="0" active="1" splitpos="0" zoom_1="1" zoom_2="0">
+		<Cursor>
+			<Cursor1 position="36698" topLine="852" />
+		</Cursor>
+	</File>
+	<File name="simplelogger.cpp" open="1" top="0" tabpos="5" split="0" active="1" splitpos="0" zoom_1="0" zoom_2="0">
+		<Cursor>
+			<Cursor1 position="0" topLine="72" />
+		</Cursor>
+	</File>
+	<File name="src\SimpleSocket.cpp" open="1" top="0" tabpos="2" split="0" active="1" splitpos="0" zoom_1="0" zoom_2="0">
+		<Cursor>
+			<Cursor1 position="6005" topLine="27" />
+		</Cursor>
+	</File>
+</CodeBlocks_layout_file>

BIN
pico-tcp-service/pico-tcp/picocv.dll


+ 340 - 0
pico-tcp-service/pico-tcp/picofunctions.cpp

@@ -0,0 +1,340 @@
+#include "picofunctions.h"
+#define DEFAULT_FREQ 80000000
+
+uint32_t
+check(const string& param)
+{
+    uint32_t result = stod(param);
+    if (result > 0)
+    {
+        return uint32_t(result);
+    }
+
+    else
+        return 1;
+}
+
+bool
+ShowParameterText(string param, pugi::xml_node node)
+{
+    cout << "Showing parameter : " << param << std::endl;
+
+    if (node == nullptr)
+    {
+        cout << "ERROR no such parameter : " << param << std::endl;
+        return false;
+    }
+    if (strlen(node.text().get()) == 0)
+    {
+        cout << "ERROR no text for parameter : " << param << std::endl;
+        return false;
+    }
+
+    cout << param << " get text: " << node.text().get() << std::endl;
+    cout << param << " get as int : " << check(node.text().get()) << std::endl;
+
+    return true;
+}
+
+string
+return_fun(uint32_t value)
+{
+    string rv;
+    switch (value)
+    {
+            // return values from set channel
+        case PICO_OK: rv = "PICO_OK"; break;
+        case PICO_USER_CALLBACK: rv = "PICO_USER_CALLBACK"; break;
+        case PICO_INVALID_HANDLE: rv = "INVALID HANDLE"; break;
+        case PICO_INVALID_CHANNEL: rv = "PICO_INVALID_CHANNEL"; break;
+        case PICO_INVALID_VOLTAGE_RANGE: rv = "PICO_INVALID_VOLTAGE_RANGE"; break;
+        case PICO_DRIVER_FUNCTION: rv = "PICO_DRIVER_FUNCTION"; break;
+        case PICO_INVALID_COUPLING: rv = "PICO_INVALID_COUPLING"; break;
+        case PICO_INVALID_ANALOGUE_OFFSET: rv = "PICO_INVALID_ANALOG_OFFSET"; break;
+        case PICO_WARNING_PROBE_CHANNEL_OUT_OF_SYNC:
+            rv = "PICO_WARNING_PROBE_CHANNEL_OUT_OF_SYNC";
+            break;
+        case PICO_PROBE_NOT_POWERED_WITH_DC_POWER_SUPPLY:
+            rv = "PICO_PROBE_NOT_POWERED_WITH_DC_POWER_SUPPLY";
+            break;
+        case PICO_PROBE_POWER_DC_POWER_SUPPLY_REQUIRED:
+            rv = "PICO_PROBE_POWER_DC_POWER_SUPPLY_REQUIRED";
+            break;
+        // return values from flash led
+        case PICO_BUSY: rv = "PICO_BUSY"; break;
+        case PICO_MEMORY: rv = "PICO_MEMORY"; break;
+        case PICO_INTERNAL_ERROR: rv = "PICO_INTERNAL_ERROR"; break;
+        case PICO_POWER_SUPPLY_UNDERVOLTAGE: rv = "PICO_POWER_SUPPLY_UNDERVOLTAGE"; break;
+        case PICO_NOT_RESPONDING: rv = "PICO_NOT_RESPONDING"; break;
+        case PICO_POWER_SUPPLY_CONNECTED: rv = "PICO_POWER_SUPPLY_CONNECTED"; break;
+        case PICO_POWER_SUPPLY_NOT_CONNECTED: rv = "PICO_POWER_SUPPLY_NOT_CONNECTED"; break;
+        case PICO_TIMEOUT: rv = "PICO_TIMEOUT"; break;
+        case PICO_RESOURCE_ERROR: rv = "PICO_RESOURCE_ERROR"; break;
+        case PICO_DEVICE_NOT_FUNCTIONING: rv = "PICO_DEVICE_NOT_FUNCTIONING"; break;
+        // return values from open
+        case PICO_OS_NOT_SUPPORTED: rv = "PICO_OS_NOT_SUPPORTED"; break;
+        case PICO_OPEN_OPERATION_IN_PROGRESS: rv = "PICO_OPEN_OPERATION_IN_PROGRESS"; break;
+        case PICO_EEPROM_CORRUPT: rv = "PICO_EEPROM_CORRUPT"; break;
+        case PICO_KERNEL_DRIVER_TOO_OLD: rv = "PICO_KERNEL_DRIVER_TOO_OLD"; break;
+        case PICO_FW_FAIL: rv = "PICO_FW_FAIL"; break;
+        case PICO_MAX_UNITS_OPENED: rv = "PICO_MAX_UNITS_OPENED"; break;
+        case PICO_NOT_FOUND: rv = "PICO_NOT_FOUND"; break;
+        case PICO_USB3_0_DEVICE_NON_USB3_0_PORT: rv = "PICO_USB3_0_DEVICE_NON_USB3_0_PORT"; break;
+        case PICO_MEMORY_FAIL: rv = "PICO_MEMORY_FAIL"; break;
+        case PICO_HARDWARE_VERSION_NOT_SUPPORTED: rv = "PICO_HARDWARE_VERSION_NOT_SUPPORTED"; break;
+        case PICO_NOT_USED: rv = "PICO_NOT_USED"; break;
+        case PICO_FPGA_FAIL: rv = "PICO_FPGA_FAIL"; break;
+
+        // return values from get timebase
+        case PICO_TOO_MANY_SAMPLES: rv = "PICO_TOO_MANY_SAMPLES"; break;
+        case PICO_INVALID_TIMEBASE: rv = "PICO_INVALID_TIMEBASE"; break;
+        case PICO_INVALID_PARAMETER: rv = "PICO_INVALID_PARAMETER"; break;
+        case PICO_SEGMENT_OUT_OF_RANGE: rv = "PICO_SEGMENT_OUT_OF_RANGE"; break;
+        // return values from run block
+        case PICO_INVALID_TRIGGER_CHANNEL: rv = "PICO_INVALID_TRIGGER_CHANNEL"; break;
+        case PICO_INVALID_CONDITION_CHANNEL: rv = "PICO_INVALID_CONDITION_CHANNEL"; break;
+        case PICO_CONFIG_FAIL: rv = "PICO_CONFIG_FAIL"; break;
+        case PICO_TRIGGER_ERROR: rv = "PICO_TRIGGER_ERROR"; break;
+        case PICO_NOT_USED_IN_THIS_CAPTURE_MODE: rv = "PICO_NOT_USED_IN_THIS_CAPTURE_MODE"; break;
+        case PICO_TRIGGER_WITHIN_PRE_NOT_ALLOWED_WITH_DELAY:
+            rv = "PICO_TRIGGER_WITHIN_PRE_NOT_ALLOWED_WITH_DELAY";
+            break;
+        case PICO_INVALID_NUMBER_CHANNELS_FOR_RESOLUTION:
+            rv = "PICO_INVALID_NUMBER_CHANNELS_FOR_RESOLUTION";
+            break;
+        case PICO_NOT_ENOUGH_SEGMENTS: rv = "PICO_NOT_ENOUGH_SEGMENTS"; break;
+        case PICO_NO_TRIGGER_ENABLED_FOR_TRIGGER_IN_PRE_TRIG:
+            rv = "PICO_NO_TRIGGER_ENABLED_FOR_TRIGGER_IN_PRE_TRIG";
+            break;
+        // return values from set data buffer
+        case PICO_RATIO_MODE_NOT_SUPPORTED: rv = "PICO_RATIO_MODE_NOT_SUPPORTED"; break;
+        // return values from get values
+        case PICO_NO_SAMPLES_AVAILABLE: rv = "PICO_NO_SAMPLES_AVAILABLE"; break;
+        case PICO_DEVICE_SAMPLING: rv = "PICO_DEVICE_SAMPLING"; break;
+        case PICO_NULL_PARAMETER: rv = "PICO_NULL_PARAMETER"; break;
+        case PICO_DATA_NOT_AVAILABLE: rv = "PICO_DATA_NOT_AVAILABLE"; break;
+        case PICO_STARTINDEX_INVALID: rv = "PICO_STARTINDEX_INVALID"; break;
+        case PICO_INVALID_SAMPLERATIO: rv = "PICO_INVALID_SAMPLERATIO"; break;
+        case PICO_INVALID_CALL: rv = "PICO_INVALID_CALL"; break;
+        case PICO_BUFFERS_NOT_SET: rv = "PICO_BUFFERS_NOT_SET"; break;
+        case PICO_ETS_NOT_RUNNING: rv = "PICO_ETS_NOT_RUNNING"; break;
+        // return value from SetTriggerChannelConditions
+        case PICO_TOO_MANY_CHANNELS_IN_USE: rv = "PICO_TOO_MANY_CHANNELS_IN_USE"; break;
+        case PICO_INVALID_CONDITION_INFO: rv = "PICO_INVALID_CONDITION_INFO"; break;
+        case PICO_DUPLICATE_CONDITION_SOURCE: rv = "PICO_DUPLICATE_CONDITION_SOURCE"; break;
+        case PICO_CANCELLED: rv = "PICO_CANCELLED"; break;
+
+        default: rv = "unknown return value = " + std::to_string(value);
+    }
+    return rv;
+}
+
+Parse_data
+parse_xml_function(const char* file_name)
+{
+    pugi::xml_document doc;
+    pugi::xml_parse_result result = doc.load_file(file_name);
+
+    if (!result)
+    {
+        std::cerr << "Ошибка загрузки XML-файла: " << result.description() << std::endl;
+    }
+
+    pugi::xml_node root = doc.child("root");
+
+    string points = root.child("points").child("value").text().as_string();
+    int32_t num_of_channels = root.child("num_of_channels").child("value").text().as_int();
+    string times = root.child("times").child("value").text().as_string();
+    int32_t sample_freq = root.child("sample_freq").child("value").text().as_int();
+
+    return std::make_tuple(points, num_of_channels, times, sample_freq);
+}
+
+std::vector<uint32_t>
+string_to_vector(string times)
+{
+    times = times.substr(1, times.length() - 2);
+
+    std::vector<uint32_t> vec_times;
+    std::stringstream ss(times);
+    string token;
+
+    while (std::getline(ss, token, ','))
+    {
+        vec_times.push_back(std::stoi(token));
+    }
+
+    return vec_times;
+}
+
+std::vector<PS4000A_CHANNEL>
+create_channel(const int32_t& num_of_channels)
+{
+    std::vector<PS4000A_CHANNEL> channels;
+
+    for (int32_t i = 0; i < num_of_channels; i++)
+    {
+        switch (i)
+        {
+            case 0:
+            {
+                PS4000A_CHANNEL trigger_channel{PS4000A_CHANNEL_A};
+                channels.push_back(trigger_channel);
+                break;
+            }
+            case 1:
+            {
+                PS4000A_CHANNEL data2_channel{PS4000A_CHANNEL_B};
+                channels.push_back(data2_channel);
+                break;
+            }
+            case 2:
+            {
+                PS4000A_CHANNEL data3_channel{PS4000A_CHANNEL_C};
+                channels.push_back(data3_channel);
+                break;
+            }
+            case 3:
+            {
+                PS4000A_CHANNEL data4_channel{PS4000A_CHANNEL_D};
+                channels.push_back(data4_channel);
+                break;
+            }
+            case 4:
+            {
+                PS4000A_CHANNEL data5_channel{PS4000A_CHANNEL_E};
+                channels.push_back(data5_channel);
+                break;
+            }
+            case 5:
+            {
+                PS4000A_CHANNEL data6_channel{PS4000A_CHANNEL_F};
+                channels.push_back(data6_channel);
+                break;
+            }
+            case 6:
+            {
+                PS4000A_CHANNEL data7_channel{PS4000A_CHANNEL_G};
+                channels.push_back(data7_channel);
+                break;
+            }
+            case 7:
+            {
+                PS4000A_CHANNEL data8_channel{PS4000A_CHANNEL_H};
+                channels.push_back(data8_channel);
+                break;
+            }
+        }
+    }
+    return channels;
+}
+
+void writing_data(const std::vector<int16_t*>& vec_buffer, const int32_t bufferLth,
+                  const int32_t NUMBER_OF_CHANNELS)
+{
+    // Получаем текущее время
+    std::time_t now = std::time(nullptr);
+    std::tm* now_tm = std::localtime(&now);
+
+    #ifdef _WIN32
+    CreateDirectoryA("output", NULL);
+    #endif // _WIN32
+
+    // Формируем имя файла с текущей датой и временем
+    std::stringstream filename;
+
+    #ifdef _WIN32
+    filename << "output\\";
+    #endif // _WIN32
+
+    filename << "data_"
+             << std::put_time(now_tm, "%Y-%m-%d_%H-%M-%S")
+             << ".csv";
+
+
+
+    // Открываем новый файл для записи (не для дозаписи)
+    std::ofstream testfile(filename.str());
+
+    if (testfile.is_open())
+    {
+        for (int i = 0; i < bufferLth; ++i)
+        {
+            for (int j = 0; j < NUMBER_OF_CHANNELS; ++j)
+            {
+                testfile << vec_buffer[j][i] << ",";  // Вывод значений
+            }
+
+            testfile << "\n";
+        }
+
+        testfile.close();
+    }
+    else
+    {
+        // Обработка ошибки открытия файла, если необходимо
+       std::cerr << "Unable to open file to write data" ;
+    }
+}
+
+void writing_data_fixed_name(const std::string name, const std::vector<int16_t*>& vec_buffer, const int32_t bufferLth,
+                  const int32_t NUMBER_OF_CHANNELS)
+{
+    // Получаем текущее время
+    std::time_t now = std::time(nullptr);
+    std::tm* now_tm = std::localtime(&now);
+
+    #ifdef _WIN32
+    CreateDirectoryA("output", NULL);
+    #endif // _WIN32
+
+    // Формируем имя файла с текущей датой и временем
+    std::stringstream filename;
+
+    #ifdef _WIN32
+    filename << "output\\";
+    #endif // _WIN32
+
+    filename << name
+             << ".csv";
+
+
+
+    // Открываем новый файл для записи (не для дозаписи)
+    std::ofstream testfile(filename.str());
+
+    if (testfile.is_open())
+    {
+        for (int i = 0; i < bufferLth; ++i)
+        {
+            for (int j = 0; j < NUMBER_OF_CHANNELS; ++j)
+            {
+                testfile << vec_buffer[j][i] << ",";  // Вывод значений
+            }
+
+            testfile << "\n";
+        }
+
+        testfile.close();
+    }
+    else
+    {
+        // Обработка ошибки открытия файла, если необходимо
+       std::cerr << "Unable to open file to write data" ;
+    }
+}
+
+void
+free_buffers(const std::vector<int16_t*>& vec_buffer)
+{
+    for (const auto& it : vec_buffer)
+    {
+        delete[] it;
+    }
+}
+
+uint32_t
+timebase_choice(const int32_t SAMPLE_FREQ)
+{
+    return DEFAULT_FREQ / SAMPLE_FREQ - 1;
+}

+ 75 - 0
pico-tcp-service/pico-tcp/picofunctions.h

@@ -0,0 +1,75 @@
+#pragma once
+
+#include <stdio.h>
+
+#include <algorithm>
+#include <chrono>
+#include <fstream>
+#include <iomanip>
+#include <iostream>
+#include <thread>
+#include <tuple>
+#include <vector>
+
+#include "pugixml.hpp"
+
+/* Headers for Windows */
+#if defined(_WIN32) || defined(_WIN64)
+#include <conio.h>
+
+#include "windows.h"
+
+#endif
+
+#include <stdio.h>
+
+#include <chrono>
+#include <cstring>
+#include <thread>
+
+#include "libps4000a/PicoStatus.h"
+#include "libps4000a/ps4000aApi.h"
+#include "pugiconfig.hpp"
+#include "pugixml.hpp"
+
+#define filename_xml "Pico_param.XML"
+
+using std::cout;
+using std::endl;
+using std::string;
+
+typedef std::tuple<string, int32_t, string, int32_t> Parse_data;
+
+uint32_t
+check(const string &);
+
+bool ShowParameterText(string, pugi::xml_node);
+
+string
+return_fun(uint32_t);
+
+Parse_data
+parse_xml_function(const char *);
+
+std::vector<uint32_t> string_to_vector(string);
+
+std::vector<PS4000A_CHANNEL>
+create_channel(const int32_t &);
+
+void
+writing_data(const std::vector<int16_t *> &, const int32_t, const int32_t);
+
+void writing_data_fixed_name(const std::string, const std::vector<int16_t*>&, const int32_t,
+                  const int32_t);
+
+void
+free_buffers(const std::vector<int16_t *> &);
+
+uint32_t
+timebase_choice(const int32_t);
+
+void
+set_data_buffer(const int32_t, const int32_t);
+
+void
+get_values();

BIN
pico-tcp-service/pico-tcp/picoipp.dll


BIN
pico-tcp-service/pico-tcp/ps4000a.dll


BIN
pico-tcp-service/pico-tcp/ps4000a.lib


+ 77 - 0
pico-tcp-service/pico-tcp/pugiconfig.hpp

@@ -0,0 +1,77 @@
+/**
+ * pugixml parser - version 1.14
+ * --------------------------------------------------------
+ * Copyright (C) 2006-2023, by Arseny Kapoulkine (arseny.kapoulkine@gmail.com)
+ * Report bugs and download new versions at https://pugixml.org/
+ *
+ * This library is distributed under the MIT License. See notice at the end
+ * of this file.
+ *
+ * This work is based on the pugxml parser, which is:
+ * Copyright (C) 2003, by Kristen Wegner (kristen@tima.net)
+ */
+
+#ifndef HEADER_PUGICONFIG_HPP
+#define HEADER_PUGICONFIG_HPP
+
+// Uncomment this to enable wchar_t mode
+// #define PUGIXML_WCHAR_MODE
+
+// Uncomment this to enable compact mode
+// #define PUGIXML_COMPACT
+
+// Uncomment this to disable XPath
+// #define PUGIXML_NO_XPATH
+
+// Uncomment this to disable STL
+// #define PUGIXML_NO_STL
+
+// Uncomment this to disable exceptions
+// #define PUGIXML_NO_EXCEPTIONS
+
+// Set this to control attributes for public classes/functions, i.e.:
+// #define PUGIXML_API __declspec(dllexport) // to export all public symbols from DLL
+// #define PUGIXML_CLASS __declspec(dllimport) // to import all classes from DLL
+// #define PUGIXML_FUNCTION __fastcall // to set calling conventions to all public functions to fastcall
+// In absence of PUGIXML_CLASS/PUGIXML_FUNCTION definitions PUGIXML_API is used instead
+
+// Tune these constants to adjust memory-related behavior
+// #define PUGIXML_MEMORY_PAGE_SIZE 32768
+// #define PUGIXML_MEMORY_OUTPUT_STACK 10240
+// #define PUGIXML_MEMORY_XPATH_PAGE_SIZE 4096
+
+// Tune this constant to adjust max nesting for XPath queries
+// #define PUGIXML_XPATH_DEPTH_LIMIT 1024
+
+// Uncomment this to switch to header-only version
+// #define PUGIXML_HEADER_ONLY
+
+// Uncomment this to enable long long support
+// #define PUGIXML_HAS_LONG_LONG
+
+#endif
+
+/**
+ * Copyright (c) 2006-2023 Arseny Kapoulkine
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */

+ 13226 - 0
pico-tcp-service/pico-tcp/pugixml.cpp

@@ -0,0 +1,13226 @@
+/**
+ * pugixml parser - version 1.14
+ * --------------------------------------------------------
+ * Copyright (C) 2006-2023, by Arseny Kapoulkine (arseny.kapoulkine@gmail.com)
+ * Report bugs and download new versions at https://pugixml.org/
+ *
+ * This library is distributed under the MIT License. See notice at the end
+ * of this file.
+ *
+ * This work is based on the pugxml parser, which is:
+ * Copyright (C) 2003, by Kristen Wegner (kristen@tima.net)
+ */
+
+#ifndef SOURCE_PUGIXML_CPP
+#define SOURCE_PUGIXML_CPP
+
+#include "pugixml.hpp"
+
+#include <stdlib.h>
+#include <stdio.h>
+#include <string.h>
+#include <assert.h>
+#include <limits.h>
+
+#ifdef PUGIXML_WCHAR_MODE
+#	include <wchar.h>
+#endif
+
+#ifndef PUGIXML_NO_XPATH
+#	include <math.h>
+#	include <float.h>
+#endif
+
+#ifndef PUGIXML_NO_STL
+#	include <istream>
+#	include <ostream>
+#	include <string>
+#endif
+
+// For placement new
+#include <new>
+
+// For load_file
+#if defined(__linux__) || defined(__APPLE__)
+#include <sys/stat.h>
+#endif
+
+#ifdef _MSC_VER
+#	pragma warning(push)
+#	pragma warning(disable: 4127) // conditional expression is constant
+#	pragma warning(disable: 4324) // structure was padded due to __declspec(align())
+#	pragma warning(disable: 4702) // unreachable code
+#	pragma warning(disable: 4996) // this function or variable may be unsafe
+#endif
+
+#if defined(_MSC_VER) && defined(__c2__)
+#	pragma clang diagnostic push
+#	pragma clang diagnostic ignored "-Wdeprecated" // this function or variable may be unsafe
+#endif
+
+#ifdef __INTEL_COMPILER
+#	pragma warning(disable: 177) // function was declared but never referenced
+#	pragma warning(disable: 279) // controlling expression is constant
+#	pragma warning(disable: 1478 1786) // function was declared "deprecated"
+#	pragma warning(disable: 1684) // conversion from pointer to same-sized integral type
+#endif
+
+#if defined(__BORLANDC__) && defined(PUGIXML_HEADER_ONLY)
+#	pragma warn -8080 // symbol is declared but never used; disabling this inside push/pop bracket does not make the warning go away
+#endif
+
+#ifdef __BORLANDC__
+#	pragma option push
+#	pragma warn -8008 // condition is always false
+#	pragma warn -8066 // unreachable code
+#endif
+
+#ifdef __SNC__
+// Using diag_push/diag_pop does not disable the warnings inside templates due to a compiler bug
+#	pragma diag_suppress=178 // function was declared but never referenced
+#	pragma diag_suppress=237 // controlling expression is constant
+#endif
+
+#ifdef __TI_COMPILER_VERSION__
+#	pragma diag_suppress 179 // function was declared but never referenced
+#endif
+
+// Inlining controls
+#if defined(_MSC_VER) && _MSC_VER >= 1300
+#	define PUGI_IMPL_NO_INLINE __declspec(noinline)
+#elif defined(__GNUC__)
+#	define PUGI_IMPL_NO_INLINE __attribute__((noinline))
+#else
+#	define PUGI_IMPL_NO_INLINE
+#endif
+
+// Branch weight controls
+#if defined(__GNUC__) && !defined(__c2__)
+#	define PUGI_IMPL_UNLIKELY(cond) __builtin_expect(cond, 0)
+#else
+#	define PUGI_IMPL_UNLIKELY(cond) (cond)
+#endif
+
+// Simple static assertion
+#define PUGI_IMPL_STATIC_ASSERT(cond) { static const char condition_failed[(cond) ? 1 : -1] = {0}; (void)condition_failed[0]; }
+
+// Digital Mars C++ bug workaround for passing char loaded from memory via stack
+#ifdef __DMC__
+#	define PUGI_IMPL_DMC_VOLATILE volatile
+#else
+#	define PUGI_IMPL_DMC_VOLATILE
+#endif
+
+// Integer sanitizer workaround; we only apply this for clang since gcc8 has no_sanitize but not unsigned-integer-overflow and produces "attribute directive ignored" warnings
+#if defined(__clang__) && defined(__has_attribute)
+#	if __has_attribute(no_sanitize)
+#		define PUGI_IMPL_UNSIGNED_OVERFLOW __attribute__((no_sanitize("unsigned-integer-overflow")))
+#	else
+#		define PUGI_IMPL_UNSIGNED_OVERFLOW
+#	endif
+#else
+#	define PUGI_IMPL_UNSIGNED_OVERFLOW
+#endif
+
+// Borland C++ bug workaround for not defining ::memcpy depending on header include order (can't always use std::memcpy because some compilers don't have it at all)
+#if defined(__BORLANDC__) && !defined(__MEM_H_USING_LIST)
+using std::memcpy;
+using std::memmove;
+using std::memset;
+#endif
+
+// Old versions of GCC do not define ::malloc and ::free depending on header include order
+#if defined(__GNUC__) && (__GNUC__ < 3 || (__GNUC__ == 3 && __GNUC_MINOR__ < 4))
+using std::malloc;
+using std::free;
+#endif
+
+// Some MinGW/GCC versions have headers that erroneously omit LLONG_MIN/LLONG_MAX/ULLONG_MAX definitions from limits.h in some configurations
+#if defined(PUGIXML_HAS_LONG_LONG) && defined(__GNUC__) && !defined(LLONG_MAX) && !defined(LLONG_MIN) && !defined(ULLONG_MAX)
+#	define LLONG_MIN (-LLONG_MAX - 1LL)
+#	define LLONG_MAX __LONG_LONG_MAX__
+#	define ULLONG_MAX (LLONG_MAX * 2ULL + 1ULL)
+#endif
+
+// In some environments MSVC is a compiler but the CRT lacks certain MSVC-specific features
+#if defined(_MSC_VER) && !defined(__S3E__) && !defined(_WIN32_WCE)
+#	define PUGI_IMPL_MSVC_CRT_VERSION _MSC_VER
+#elif defined(_WIN32_WCE)
+#	define PUGI_IMPL_MSVC_CRT_VERSION 1310 // MSVC7.1
+#endif
+
+// Not all platforms have snprintf; we define a wrapper that uses snprintf if possible. This only works with buffers with a known size.
+#if __cplusplus >= 201103
+#	define PUGI_IMPL_SNPRINTF(buf, ...) snprintf(buf, sizeof(buf), __VA_ARGS__)
+#elif defined(PUGI_IMPL_MSVC_CRT_VERSION) && PUGI_IMPL_MSVC_CRT_VERSION >= 1400
+#	define PUGI_IMPL_SNPRINTF(buf, ...) _snprintf_s(buf, _countof(buf), _TRUNCATE, __VA_ARGS__)
+#elif defined(__APPLE__) && __clang_major__ >= 14 // Xcode 14 marks sprintf as deprecated while still using C++98 by default
+#	define PUGI_IMPL_SNPRINTF(buf, fmt, arg1, arg2) snprintf(buf, sizeof(buf), fmt, arg1, arg2)
+#else
+#	define PUGI_IMPL_SNPRINTF sprintf
+#endif
+
+// We put implementation details into an anonymous namespace in source mode, but have to keep it in non-anonymous namespace in header-only mode to prevent binary bloat.
+#ifdef PUGIXML_HEADER_ONLY
+#	define PUGI_IMPL_NS_BEGIN namespace pugi { namespace impl {
+#	define PUGI_IMPL_NS_END } }
+#	define PUGI_IMPL_FN inline
+#	define PUGI_IMPL_FN_NO_INLINE inline
+#else
+#	if defined(_MSC_VER) && _MSC_VER < 1300 // MSVC6 seems to have an amusing bug with anonymous namespaces inside namespaces
+#		define PUGI_IMPL_NS_BEGIN namespace pugi { namespace impl {
+#		define PUGI_IMPL_NS_END } }
+#	else
+#		define PUGI_IMPL_NS_BEGIN namespace pugi { namespace impl { namespace {
+#		define PUGI_IMPL_NS_END } } }
+#	endif
+#	define PUGI_IMPL_FN
+#	define PUGI_IMPL_FN_NO_INLINE PUGI_IMPL_NO_INLINE
+#endif
+
+// uintptr_t
+#if (defined(_MSC_VER) && _MSC_VER < 1600) || (defined(__BORLANDC__) && __BORLANDC__ < 0x561)
+namespace pugi
+{
+#	ifndef _UINTPTR_T_DEFINED
+	typedef size_t uintptr_t;
+#	endif
+
+	typedef unsigned __int8 uint8_t;
+	typedef unsigned __int16 uint16_t;
+	typedef unsigned __int32 uint32_t;
+}
+#else
+#	include <stdint.h>
+#endif
+
+// Memory allocation
+PUGI_IMPL_NS_BEGIN
+	PUGI_IMPL_FN void* default_allocate(size_t size)
+	{
+		return malloc(size);
+	}
+
+	PUGI_IMPL_FN void default_deallocate(void* ptr)
+	{
+		free(ptr);
+	}
+
+	template <typename T>
+	struct xml_memory_management_function_storage
+	{
+		static allocation_function allocate;
+		static deallocation_function deallocate;
+	};
+
+	// Global allocation functions are stored in class statics so that in header mode linker deduplicates them
+	// Without a template<> we'll get multiple definitions of the same static
+	template <typename T> allocation_function xml_memory_management_function_storage<T>::allocate = default_allocate;
+	template <typename T> deallocation_function xml_memory_management_function_storage<T>::deallocate = default_deallocate;
+
+	typedef xml_memory_management_function_storage<int> xml_memory;
+PUGI_IMPL_NS_END
+
+// String utilities
+PUGI_IMPL_NS_BEGIN
+	// Get string length
+	PUGI_IMPL_FN size_t strlength(const char_t* s)
+	{
+		assert(s);
+
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcslen(s);
+	#else
+		return strlen(s);
+	#endif
+	}
+
+	// Compare two strings
+	PUGI_IMPL_FN bool strequal(const char_t* src, const char_t* dst)
+	{
+		assert(src && dst);
+
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcscmp(src, dst) == 0;
+	#else
+		return strcmp(src, dst) == 0;
+	#endif
+	}
+
+	// Compare lhs with [rhs_begin, rhs_end)
+	PUGI_IMPL_FN bool strequalrange(const char_t* lhs, const char_t* rhs, size_t count)
+	{
+		for (size_t i = 0; i < count; ++i)
+			if (lhs[i] != rhs[i])
+				return false;
+
+		return lhs[count] == 0;
+	}
+
+	// Get length of wide string, even if CRT lacks wide character support
+	PUGI_IMPL_FN size_t strlength_wide(const wchar_t* s)
+	{
+		assert(s);
+
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcslen(s);
+	#else
+		const wchar_t* end = s;
+		while (*end) end++;
+		return static_cast<size_t>(end - s);
+	#endif
+	}
+PUGI_IMPL_NS_END
+
+// auto_ptr-like object for exception recovery
+PUGI_IMPL_NS_BEGIN
+	template <typename T> struct auto_deleter
+	{
+		typedef void (*D)(T*);
+
+		T* data;
+		D deleter;
+
+		auto_deleter(T* data_, D deleter_): data(data_), deleter(deleter_)
+		{
+		}
+
+		~auto_deleter()
+		{
+			if (data) deleter(data);
+		}
+
+		T* release()
+		{
+			T* result = data;
+			data = 0;
+			return result;
+		}
+	};
+PUGI_IMPL_NS_END
+
+#ifdef PUGIXML_COMPACT
+PUGI_IMPL_NS_BEGIN
+	class compact_hash_table
+	{
+	public:
+		compact_hash_table(): _items(0), _capacity(0), _count(0)
+		{
+		}
+
+		void clear()
+		{
+			if (_items)
+			{
+				xml_memory::deallocate(_items);
+				_items = 0;
+				_capacity = 0;
+				_count = 0;
+			}
+		}
+
+		void* find(const void* key)
+		{
+			if (_capacity == 0) return 0;
+
+			item_t* item = get_item(key);
+			assert(item);
+			assert(item->key == key || (item->key == 0 && item->value == 0));
+
+			return item->value;
+		}
+
+		void insert(const void* key, void* value)
+		{
+			assert(_capacity != 0 && _count < _capacity - _capacity / 4);
+
+			item_t* item = get_item(key);
+			assert(item);
+
+			if (item->key == 0)
+			{
+				_count++;
+				item->key = key;
+			}
+
+			item->value = value;
+		}
+
+		bool reserve(size_t extra = 16)
+		{
+			if (_count + extra >= _capacity - _capacity / 4)
+				return rehash(_count + extra);
+
+			return true;
+		}
+
+	private:
+		struct item_t
+		{
+			const void* key;
+			void* value;
+		};
+
+		item_t* _items;
+		size_t _capacity;
+
+		size_t _count;
+
+		bool rehash(size_t count);
+
+		item_t* get_item(const void* key)
+		{
+			assert(key);
+			assert(_capacity > 0);
+
+			size_t hashmod = _capacity - 1;
+			size_t bucket = hash(key) & hashmod;
+
+			for (size_t probe = 0; probe <= hashmod; ++probe)
+			{
+				item_t& probe_item = _items[bucket];
+
+				if (probe_item.key == key || probe_item.key == 0)
+					return &probe_item;
+
+				// hash collision, quadratic probing
+				bucket = (bucket + probe + 1) & hashmod;
+			}
+
+			assert(false && "Hash table is full"); // unreachable
+			return 0;
+		}
+
+		static PUGI_IMPL_UNSIGNED_OVERFLOW unsigned int hash(const void* key)
+		{
+			unsigned int h = static_cast<unsigned int>(reinterpret_cast<uintptr_t>(key) & 0xffffffff);
+
+			// MurmurHash3 32-bit finalizer
+			h ^= h >> 16;
+			h *= 0x85ebca6bu;
+			h ^= h >> 13;
+			h *= 0xc2b2ae35u;
+			h ^= h >> 16;
+
+			return h;
+		}
+	};
+
+	PUGI_IMPL_FN_NO_INLINE bool compact_hash_table::rehash(size_t count)
+	{
+		size_t capacity = 32;
+		while (count >= capacity - capacity / 4)
+			capacity *= 2;
+
+		compact_hash_table rt;
+		rt._capacity = capacity;
+		rt._items = static_cast<item_t*>(xml_memory::allocate(sizeof(item_t) * capacity));
+
+		if (!rt._items)
+			return false;
+
+		memset(rt._items, 0, sizeof(item_t) * capacity);
+
+		for (size_t i = 0; i < _capacity; ++i)
+			if (_items[i].key)
+				rt.insert(_items[i].key, _items[i].value);
+
+		if (_items)
+			xml_memory::deallocate(_items);
+
+		_capacity = capacity;
+		_items = rt._items;
+
+		assert(_count == rt._count);
+
+		return true;
+	}
+
+PUGI_IMPL_NS_END
+#endif
+
+PUGI_IMPL_NS_BEGIN
+#ifdef PUGIXML_COMPACT
+	static const uintptr_t xml_memory_block_alignment = 4;
+#else
+	static const uintptr_t xml_memory_block_alignment = sizeof(void*);
+#endif
+
+	// extra metadata bits
+	static const uintptr_t xml_memory_page_contents_shared_mask = 64;
+	static const uintptr_t xml_memory_page_name_allocated_mask = 32;
+	static const uintptr_t xml_memory_page_value_allocated_mask = 16;
+	static const uintptr_t xml_memory_page_type_mask = 15;
+
+	// combined masks for string uniqueness
+	static const uintptr_t xml_memory_page_name_allocated_or_shared_mask = xml_memory_page_name_allocated_mask | xml_memory_page_contents_shared_mask;
+	static const uintptr_t xml_memory_page_value_allocated_or_shared_mask = xml_memory_page_value_allocated_mask | xml_memory_page_contents_shared_mask;
+
+#ifdef PUGIXML_COMPACT
+	#define PUGI_IMPL_GETHEADER_IMPL(object, page, flags) // unused
+	#define PUGI_IMPL_GETPAGE_IMPL(header) (header).get_page()
+#else
+	#define PUGI_IMPL_GETHEADER_IMPL(object, page, flags) (((reinterpret_cast<char*>(object) - reinterpret_cast<char*>(page)) << 8) | (flags))
+	// this macro casts pointers through void* to avoid 'cast increases required alignment of target type' warnings
+	#define PUGI_IMPL_GETPAGE_IMPL(header) static_cast<impl::xml_memory_page*>(const_cast<void*>(static_cast<const void*>(reinterpret_cast<const char*>(&header) - (header >> 8))))
+#endif
+
+	#define PUGI_IMPL_GETPAGE(n) PUGI_IMPL_GETPAGE_IMPL((n)->header)
+	#define PUGI_IMPL_NODETYPE(n) static_cast<xml_node_type>((n)->header & impl::xml_memory_page_type_mask)
+
+	struct xml_allocator;
+
+	struct xml_memory_page
+	{
+		static xml_memory_page* construct(void* memory)
+		{
+			xml_memory_page* result = static_cast<xml_memory_page*>(memory);
+
+			result->allocator = 0;
+			result->prev = 0;
+			result->next = 0;
+			result->busy_size = 0;
+			result->freed_size = 0;
+
+		#ifdef PUGIXML_COMPACT
+			result->compact_string_base = 0;
+			result->compact_shared_parent = 0;
+			result->compact_page_marker = 0;
+		#endif
+
+			return result;
+		}
+
+		xml_allocator* allocator;
+
+		xml_memory_page* prev;
+		xml_memory_page* next;
+
+		size_t busy_size;
+		size_t freed_size;
+
+	#ifdef PUGIXML_COMPACT
+		char_t* compact_string_base;
+		void* compact_shared_parent;
+		uint32_t* compact_page_marker;
+	#endif
+	};
+
+	static const size_t xml_memory_page_size =
+	#ifdef PUGIXML_MEMORY_PAGE_SIZE
+		(PUGIXML_MEMORY_PAGE_SIZE)
+	#else
+		32768
+	#endif
+		- sizeof(xml_memory_page);
+
+	struct xml_memory_string_header
+	{
+		uint16_t page_offset; // offset from page->data
+		uint16_t full_size; // 0 if string occupies whole page
+	};
+
+	struct xml_allocator
+	{
+		xml_allocator(xml_memory_page* root): _root(root), _busy_size(root->busy_size)
+		{
+		#ifdef PUGIXML_COMPACT
+			_hash = 0;
+		#endif
+		}
+
+		xml_memory_page* allocate_page(size_t data_size)
+		{
+			size_t size = sizeof(xml_memory_page) + data_size;
+
+			// allocate block with some alignment, leaving memory for worst-case padding
+			void* memory = xml_memory::allocate(size);
+			if (!memory) return 0;
+
+			// prepare page structure
+			xml_memory_page* page = xml_memory_page::construct(memory);
+			assert(page);
+
+			assert(this == _root->allocator);
+			page->allocator = this;
+
+			return page;
+		}
+
+		static void deallocate_page(xml_memory_page* page)
+		{
+			xml_memory::deallocate(page);
+		}
+
+		void* allocate_memory_oob(size_t size, xml_memory_page*& out_page);
+
+		void* allocate_memory(size_t size, xml_memory_page*& out_page)
+		{
+			if (PUGI_IMPL_UNLIKELY(_busy_size + size > xml_memory_page_size))
+				return allocate_memory_oob(size, out_page);
+
+			void* buf = reinterpret_cast<char*>(_root) + sizeof(xml_memory_page) + _busy_size;
+
+			_busy_size += size;
+
+			out_page = _root;
+
+			return buf;
+		}
+
+	#ifdef PUGIXML_COMPACT
+		void* allocate_object(size_t size, xml_memory_page*& out_page)
+		{
+			void* result = allocate_memory(size + sizeof(uint32_t), out_page);
+			if (!result) return 0;
+
+			// adjust for marker
+			ptrdiff_t offset = static_cast<char*>(result) - reinterpret_cast<char*>(out_page->compact_page_marker);
+
+			if (PUGI_IMPL_UNLIKELY(static_cast<uintptr_t>(offset) >= 256 * xml_memory_block_alignment))
+			{
+				// insert new marker
+				uint32_t* marker = static_cast<uint32_t*>(result);
+
+				*marker = static_cast<uint32_t>(reinterpret_cast<char*>(marker) - reinterpret_cast<char*>(out_page));
+				out_page->compact_page_marker = marker;
+
+				// since we don't reuse the page space until we reallocate it, we can just pretend that we freed the marker block
+				// this will make sure deallocate_memory correctly tracks the size
+				out_page->freed_size += sizeof(uint32_t);
+
+				return marker + 1;
+			}
+			else
+			{
+				// roll back uint32_t part
+				_busy_size -= sizeof(uint32_t);
+
+				return result;
+			}
+		}
+	#else
+		void* allocate_object(size_t size, xml_memory_page*& out_page)
+		{
+			return allocate_memory(size, out_page);
+		}
+	#endif
+
+		void deallocate_memory(void* ptr, size_t size, xml_memory_page* page)
+		{
+			if (page == _root) page->busy_size = _busy_size;
+
+			assert(ptr >= reinterpret_cast<char*>(page) + sizeof(xml_memory_page) && ptr < reinterpret_cast<char*>(page) + sizeof(xml_memory_page) + page->busy_size);
+			(void)!ptr;
+
+			page->freed_size += size;
+			assert(page->freed_size <= page->busy_size);
+
+			if (page->freed_size == page->busy_size)
+			{
+				if (page->next == 0)
+				{
+					assert(_root == page);
+
+					// top page freed, just reset sizes
+					page->busy_size = 0;
+					page->freed_size = 0;
+
+				#ifdef PUGIXML_COMPACT
+					// reset compact state to maximize efficiency
+					page->compact_string_base = 0;
+					page->compact_shared_parent = 0;
+					page->compact_page_marker = 0;
+				#endif
+
+					_busy_size = 0;
+				}
+				else
+				{
+					assert(_root != page);
+					assert(page->prev);
+
+					// remove from the list
+					page->prev->next = page->next;
+					page->next->prev = page->prev;
+
+					// deallocate
+					deallocate_page(page);
+				}
+			}
+		}
+
+		char_t* allocate_string(size_t length)
+		{
+			static const size_t max_encoded_offset = (1 << 16) * xml_memory_block_alignment;
+
+			PUGI_IMPL_STATIC_ASSERT(xml_memory_page_size <= max_encoded_offset);
+
+			// allocate memory for string and header block
+			size_t size = sizeof(xml_memory_string_header) + length * sizeof(char_t);
+
+			// round size up to block alignment boundary
+			size_t full_size = (size + (xml_memory_block_alignment - 1)) & ~(xml_memory_block_alignment - 1);
+
+			xml_memory_page* page;
+			xml_memory_string_header* header = static_cast<xml_memory_string_header*>(allocate_memory(full_size, page));
+
+			if (!header) return 0;
+
+			// setup header
+			ptrdiff_t page_offset = reinterpret_cast<char*>(header) - reinterpret_cast<char*>(page) - sizeof(xml_memory_page);
+
+			assert(page_offset % xml_memory_block_alignment == 0);
+			assert(page_offset >= 0 && static_cast<size_t>(page_offset) < max_encoded_offset);
+			header->page_offset = static_cast<uint16_t>(static_cast<size_t>(page_offset) / xml_memory_block_alignment);
+
+			// full_size == 0 for large strings that occupy the whole page
+			assert(full_size % xml_memory_block_alignment == 0);
+			assert(full_size < max_encoded_offset || (page->busy_size == full_size && page_offset == 0));
+			header->full_size = static_cast<uint16_t>(full_size < max_encoded_offset ? full_size / xml_memory_block_alignment : 0);
+
+			// round-trip through void* to avoid 'cast increases required alignment of target type' warning
+			// header is guaranteed a pointer-sized alignment, which should be enough for char_t
+			return static_cast<char_t*>(static_cast<void*>(header + 1));
+		}
+
+		void deallocate_string(char_t* string)
+		{
+			// this function casts pointers through void* to avoid 'cast increases required alignment of target type' warnings
+			// we're guaranteed the proper (pointer-sized) alignment on the input string if it was allocated via allocate_string
+
+			// get header
+			xml_memory_string_header* header = static_cast<xml_memory_string_header*>(static_cast<void*>(string)) - 1;
+			assert(header);
+
+			// deallocate
+			size_t page_offset = sizeof(xml_memory_page) + header->page_offset * xml_memory_block_alignment;
+			xml_memory_page* page = reinterpret_cast<xml_memory_page*>(static_cast<void*>(reinterpret_cast<char*>(header) - page_offset));
+
+			// if full_size == 0 then this string occupies the whole page
+			size_t full_size = header->full_size == 0 ? page->busy_size : header->full_size * xml_memory_block_alignment;
+
+			deallocate_memory(header, full_size, page);
+		}
+
+		bool reserve()
+		{
+		#ifdef PUGIXML_COMPACT
+			return _hash->reserve();
+		#else
+			return true;
+		#endif
+		}
+
+		xml_memory_page* _root;
+		size_t _busy_size;
+
+	#ifdef PUGIXML_COMPACT
+		compact_hash_table* _hash;
+	#endif
+	};
+
+	PUGI_IMPL_FN_NO_INLINE void* xml_allocator::allocate_memory_oob(size_t size, xml_memory_page*& out_page)
+	{
+		const size_t large_allocation_threshold = xml_memory_page_size / 4;
+
+		xml_memory_page* page = allocate_page(size <= large_allocation_threshold ? xml_memory_page_size : size);
+		out_page = page;
+
+		if (!page) return 0;
+
+		if (size <= large_allocation_threshold)
+		{
+			_root->busy_size = _busy_size;
+
+			// insert page at the end of linked list
+			page->prev = _root;
+			_root->next = page;
+			_root = page;
+
+			_busy_size = size;
+		}
+		else
+		{
+			// insert page before the end of linked list, so that it is deleted as soon as possible
+			// the last page is not deleted even if it's empty (see deallocate_memory)
+			assert(_root->prev);
+
+			page->prev = _root->prev;
+			page->next = _root;
+
+			_root->prev->next = page;
+			_root->prev = page;
+
+			page->busy_size = size;
+		}
+
+		return reinterpret_cast<char*>(page) + sizeof(xml_memory_page);
+	}
+PUGI_IMPL_NS_END
+
+#ifdef PUGIXML_COMPACT
+PUGI_IMPL_NS_BEGIN
+	static const uintptr_t compact_alignment_log2 = 2;
+	static const uintptr_t compact_alignment = 1 << compact_alignment_log2;
+
+	class compact_header
+	{
+	public:
+		compact_header(xml_memory_page* page, unsigned int flags)
+		{
+			PUGI_IMPL_STATIC_ASSERT(xml_memory_block_alignment == compact_alignment);
+
+			ptrdiff_t offset = (reinterpret_cast<char*>(this) - reinterpret_cast<char*>(page->compact_page_marker));
+			assert(offset % compact_alignment == 0 && static_cast<uintptr_t>(offset) < 256 * compact_alignment);
+
+			_page = static_cast<unsigned char>(offset >> compact_alignment_log2);
+			_flags = static_cast<unsigned char>(flags);
+		}
+
+		void operator&=(uintptr_t mod)
+		{
+			_flags &= static_cast<unsigned char>(mod);
+		}
+
+		void operator|=(uintptr_t mod)
+		{
+			_flags |= static_cast<unsigned char>(mod);
+		}
+
+		uintptr_t operator&(uintptr_t mod) const
+		{
+			return _flags & mod;
+		}
+
+		xml_memory_page* get_page() const
+		{
+			// round-trip through void* to silence 'cast increases required alignment of target type' warnings
+			const char* page_marker = reinterpret_cast<const char*>(this) - (_page << compact_alignment_log2);
+			const char* page = page_marker - *reinterpret_cast<const uint32_t*>(static_cast<const void*>(page_marker));
+
+			return const_cast<xml_memory_page*>(reinterpret_cast<const xml_memory_page*>(static_cast<const void*>(page)));
+		}
+
+	private:
+		unsigned char _page;
+		unsigned char _flags;
+	};
+
+	PUGI_IMPL_FN xml_memory_page* compact_get_page(const void* object, int header_offset)
+	{
+		const compact_header* header = reinterpret_cast<const compact_header*>(static_cast<const char*>(object) - header_offset);
+
+		return header->get_page();
+	}
+
+	template <int header_offset, typename T> PUGI_IMPL_FN_NO_INLINE T* compact_get_value(const void* object)
+	{
+		return static_cast<T*>(compact_get_page(object, header_offset)->allocator->_hash->find(object));
+	}
+
+	template <int header_offset, typename T> PUGI_IMPL_FN_NO_INLINE void compact_set_value(const void* object, T* value)
+	{
+		compact_get_page(object, header_offset)->allocator->_hash->insert(object, value);
+	}
+
+	template <typename T, int header_offset, int start = -126> class compact_pointer
+	{
+	public:
+		compact_pointer(): _data(0)
+		{
+		}
+
+		void operator=(const compact_pointer& rhs)
+		{
+			*this = rhs + 0;
+		}
+
+		void operator=(T* value)
+		{
+			if (value)
+			{
+				// value is guaranteed to be compact-aligned; 'this' is not
+				// our decoding is based on 'this' aligned to compact alignment downwards (see operator T*)
+				// so for negative offsets (e.g. -3) we need to adjust the diff by compact_alignment - 1 to
+				// compensate for arithmetic shift rounding for negative values
+				ptrdiff_t diff = reinterpret_cast<char*>(value) - reinterpret_cast<char*>(this);
+				ptrdiff_t offset = ((diff + int(compact_alignment - 1)) >> compact_alignment_log2) - start;
+
+				if (static_cast<uintptr_t>(offset) <= 253)
+					_data = static_cast<unsigned char>(offset + 1);
+				else
+				{
+					compact_set_value<header_offset>(this, value);
+
+					_data = 255;
+				}
+			}
+			else
+				_data = 0;
+		}
+
+		operator T*() const
+		{
+			if (_data)
+			{
+				if (_data < 255)
+				{
+					uintptr_t base = reinterpret_cast<uintptr_t>(this) & ~(compact_alignment - 1);
+
+					return reinterpret_cast<T*>(base + (_data - 1 + start) * compact_alignment);
+				}
+				else
+					return compact_get_value<header_offset, T>(this);
+			}
+			else
+				return 0;
+		}
+
+		T* operator->() const
+		{
+			return *this;
+		}
+
+	private:
+		unsigned char _data;
+	};
+
+	template <typename T, int header_offset> class compact_pointer_parent
+	{
+	public:
+		compact_pointer_parent(): _data(0)
+		{
+		}
+
+		void operator=(const compact_pointer_parent& rhs)
+		{
+			*this = rhs + 0;
+		}
+
+		void operator=(T* value)
+		{
+			if (value)
+			{
+				// value is guaranteed to be compact-aligned; 'this' is not
+				// our decoding is based on 'this' aligned to compact alignment downwards (see operator T*)
+				// so for negative offsets (e.g. -3) we need to adjust the diff by compact_alignment - 1 to
+				// compensate for arithmetic shift behavior for negative values
+				ptrdiff_t diff = reinterpret_cast<char*>(value) - reinterpret_cast<char*>(this);
+				ptrdiff_t offset = ((diff + int(compact_alignment - 1)) >> compact_alignment_log2) + 65533;
+
+				if (static_cast<uintptr_t>(offset) <= 65533)
+				{
+					_data = static_cast<unsigned short>(offset + 1);
+				}
+				else
+				{
+					xml_memory_page* page = compact_get_page(this, header_offset);
+
+					if (PUGI_IMPL_UNLIKELY(page->compact_shared_parent == 0))
+						page->compact_shared_parent = value;
+
+					if (page->compact_shared_parent == value)
+					{
+						_data = 65534;
+					}
+					else
+					{
+						compact_set_value<header_offset>(this, value);
+
+						_data = 65535;
+					}
+				}
+			}
+			else
+			{
+				_data = 0;
+			}
+		}
+
+		operator T*() const
+		{
+			if (_data)
+			{
+				if (_data < 65534)
+				{
+					uintptr_t base = reinterpret_cast<uintptr_t>(this) & ~(compact_alignment - 1);
+
+					return reinterpret_cast<T*>(base + (_data - 1 - 65533) * compact_alignment);
+				}
+				else if (_data == 65534)
+					return static_cast<T*>(compact_get_page(this, header_offset)->compact_shared_parent);
+				else
+					return compact_get_value<header_offset, T>(this);
+			}
+			else
+				return 0;
+		}
+
+		T* operator->() const
+		{
+			return *this;
+		}
+
+	private:
+		uint16_t _data;
+	};
+
+	template <int header_offset, int base_offset> class compact_string
+	{
+	public:
+		compact_string(): _data(0)
+		{
+		}
+
+		void operator=(const compact_string& rhs)
+		{
+			*this = rhs + 0;
+		}
+
+		void operator=(char_t* value)
+		{
+			if (value)
+			{
+				xml_memory_page* page = compact_get_page(this, header_offset);
+
+				if (PUGI_IMPL_UNLIKELY(page->compact_string_base == 0))
+					page->compact_string_base = value;
+
+				ptrdiff_t offset = value - page->compact_string_base;
+
+				if (static_cast<uintptr_t>(offset) < (65535 << 7))
+				{
+					// round-trip through void* to silence 'cast increases required alignment of target type' warnings
+					uint16_t* base = reinterpret_cast<uint16_t*>(static_cast<void*>(reinterpret_cast<char*>(this) - base_offset));
+
+					if (*base == 0)
+					{
+						*base = static_cast<uint16_t>((offset >> 7) + 1);
+						_data = static_cast<unsigned char>((offset & 127) + 1);
+					}
+					else
+					{
+						ptrdiff_t remainder = offset - ((*base - 1) << 7);
+
+						if (static_cast<uintptr_t>(remainder) <= 253)
+						{
+							_data = static_cast<unsigned char>(remainder + 1);
+						}
+						else
+						{
+							compact_set_value<header_offset>(this, value);
+
+							_data = 255;
+						}
+					}
+				}
+				else
+				{
+					compact_set_value<header_offset>(this, value);
+
+					_data = 255;
+				}
+			}
+			else
+			{
+				_data = 0;
+			}
+		}
+
+		operator char_t*() const
+		{
+			if (_data)
+			{
+				if (_data < 255)
+				{
+					xml_memory_page* page = compact_get_page(this, header_offset);
+
+					// round-trip through void* to silence 'cast increases required alignment of target type' warnings
+					const uint16_t* base = reinterpret_cast<const uint16_t*>(static_cast<const void*>(reinterpret_cast<const char*>(this) - base_offset));
+					assert(*base);
+
+					ptrdiff_t offset = ((*base - 1) << 7) + (_data - 1);
+
+					return page->compact_string_base + offset;
+				}
+				else
+				{
+					return compact_get_value<header_offset, char_t>(this);
+				}
+			}
+			else
+				return 0;
+		}
+
+	private:
+		unsigned char _data;
+	};
+PUGI_IMPL_NS_END
+#endif
+
+#ifdef PUGIXML_COMPACT
+namespace pugi
+{
+	struct xml_attribute_struct
+	{
+		xml_attribute_struct(impl::xml_memory_page* page): header(page, 0), namevalue_base(0)
+		{
+			PUGI_IMPL_STATIC_ASSERT(sizeof(xml_attribute_struct) == 8);
+		}
+
+		impl::compact_header header;
+
+		uint16_t namevalue_base;
+
+		impl::compact_string<4, 2> name;
+		impl::compact_string<5, 3> value;
+
+		impl::compact_pointer<xml_attribute_struct, 6> prev_attribute_c;
+		impl::compact_pointer<xml_attribute_struct, 7, 0> next_attribute;
+	};
+
+	struct xml_node_struct
+	{
+		xml_node_struct(impl::xml_memory_page* page, xml_node_type type): header(page, type), namevalue_base(0)
+		{
+			PUGI_IMPL_STATIC_ASSERT(sizeof(xml_node_struct) == 12);
+		}
+
+		impl::compact_header header;
+
+		uint16_t namevalue_base;
+
+		impl::compact_string<4, 2> name;
+		impl::compact_string<5, 3> value;
+
+		impl::compact_pointer_parent<xml_node_struct, 6> parent;
+
+		impl::compact_pointer<xml_node_struct, 8, 0> first_child;
+
+		impl::compact_pointer<xml_node_struct,  9>    prev_sibling_c;
+		impl::compact_pointer<xml_node_struct, 10, 0> next_sibling;
+
+		impl::compact_pointer<xml_attribute_struct, 11, 0> first_attribute;
+	};
+}
+#else
+namespace pugi
+{
+	struct xml_attribute_struct
+	{
+		xml_attribute_struct(impl::xml_memory_page* page): name(0), value(0), prev_attribute_c(0), next_attribute(0)
+		{
+			header = PUGI_IMPL_GETHEADER_IMPL(this, page, 0);
+		}
+
+		uintptr_t header;
+
+		char_t*	name;
+		char_t*	value;
+
+		xml_attribute_struct* prev_attribute_c;
+		xml_attribute_struct* next_attribute;
+	};
+
+	struct xml_node_struct
+	{
+		xml_node_struct(impl::xml_memory_page* page, xml_node_type type): name(0), value(0), parent(0), first_child(0), prev_sibling_c(0), next_sibling(0), first_attribute(0)
+		{
+			header = PUGI_IMPL_GETHEADER_IMPL(this, page, type);
+		}
+
+		uintptr_t header;
+
+		char_t* name;
+		char_t* value;
+
+		xml_node_struct* parent;
+
+		xml_node_struct* first_child;
+
+		xml_node_struct* prev_sibling_c;
+		xml_node_struct* next_sibling;
+
+		xml_attribute_struct* first_attribute;
+	};
+}
+#endif
+
+PUGI_IMPL_NS_BEGIN
+	struct xml_extra_buffer
+	{
+		char_t* buffer;
+		xml_extra_buffer* next;
+	};
+
+	struct xml_document_struct: public xml_node_struct, public xml_allocator
+	{
+		xml_document_struct(xml_memory_page* page): xml_node_struct(page, node_document), xml_allocator(page), buffer(0), extra_buffers(0)
+		{
+		}
+
+		const char_t* buffer;
+
+		xml_extra_buffer* extra_buffers;
+
+	#ifdef PUGIXML_COMPACT
+		compact_hash_table hash;
+	#endif
+	};
+
+	template <typename Object> inline xml_allocator& get_allocator(const Object* object)
+	{
+		assert(object);
+
+		return *PUGI_IMPL_GETPAGE(object)->allocator;
+	}
+
+	template <typename Object> inline xml_document_struct& get_document(const Object* object)
+	{
+		assert(object);
+
+		return *static_cast<xml_document_struct*>(PUGI_IMPL_GETPAGE(object)->allocator);
+	}
+PUGI_IMPL_NS_END
+
+// Low-level DOM operations
+PUGI_IMPL_NS_BEGIN
+	inline xml_attribute_struct* allocate_attribute(xml_allocator& alloc)
+	{
+		xml_memory_page* page;
+		void* memory = alloc.allocate_object(sizeof(xml_attribute_struct), page);
+		if (!memory) return 0;
+
+		return new (memory) xml_attribute_struct(page);
+	}
+
+	inline xml_node_struct* allocate_node(xml_allocator& alloc, xml_node_type type)
+	{
+		xml_memory_page* page;
+		void* memory = alloc.allocate_object(sizeof(xml_node_struct), page);
+		if (!memory) return 0;
+
+		return new (memory) xml_node_struct(page, type);
+	}
+
+	inline void destroy_attribute(xml_attribute_struct* a, xml_allocator& alloc)
+	{
+		if (a->header & impl::xml_memory_page_name_allocated_mask)
+			alloc.deallocate_string(a->name);
+
+		if (a->header & impl::xml_memory_page_value_allocated_mask)
+			alloc.deallocate_string(a->value);
+
+		alloc.deallocate_memory(a, sizeof(xml_attribute_struct), PUGI_IMPL_GETPAGE(a));
+	}
+
+	inline void destroy_node(xml_node_struct* n, xml_allocator& alloc)
+	{
+		if (n->header & impl::xml_memory_page_name_allocated_mask)
+			alloc.deallocate_string(n->name);
+
+		if (n->header & impl::xml_memory_page_value_allocated_mask)
+			alloc.deallocate_string(n->value);
+
+		for (xml_attribute_struct* attr = n->first_attribute; attr; )
+		{
+			xml_attribute_struct* next = attr->next_attribute;
+
+			destroy_attribute(attr, alloc);
+
+			attr = next;
+		}
+
+		for (xml_node_struct* child = n->first_child; child; )
+		{
+			xml_node_struct* next = child->next_sibling;
+
+			destroy_node(child, alloc);
+
+			child = next;
+		}
+
+		alloc.deallocate_memory(n, sizeof(xml_node_struct), PUGI_IMPL_GETPAGE(n));
+	}
+
+	inline void append_node(xml_node_struct* child, xml_node_struct* node)
+	{
+		child->parent = node;
+
+		xml_node_struct* head = node->first_child;
+
+		if (head)
+		{
+			xml_node_struct* tail = head->prev_sibling_c;
+
+			tail->next_sibling = child;
+			child->prev_sibling_c = tail;
+			head->prev_sibling_c = child;
+		}
+		else
+		{
+			node->first_child = child;
+			child->prev_sibling_c = child;
+		}
+	}
+
+	inline void prepend_node(xml_node_struct* child, xml_node_struct* node)
+	{
+		child->parent = node;
+
+		xml_node_struct* head = node->first_child;
+
+		if (head)
+		{
+			child->prev_sibling_c = head->prev_sibling_c;
+			head->prev_sibling_c = child;
+		}
+		else
+			child->prev_sibling_c = child;
+
+		child->next_sibling = head;
+		node->first_child = child;
+	}
+
+	inline void insert_node_after(xml_node_struct* child, xml_node_struct* node)
+	{
+		xml_node_struct* parent = node->parent;
+
+		child->parent = parent;
+
+		xml_node_struct* next = node->next_sibling;
+
+		if (next)
+			next->prev_sibling_c = child;
+		else
+			parent->first_child->prev_sibling_c = child;
+
+		child->next_sibling = next;
+		child->prev_sibling_c = node;
+
+		node->next_sibling = child;
+	}
+
+	inline void insert_node_before(xml_node_struct* child, xml_node_struct* node)
+	{
+		xml_node_struct* parent = node->parent;
+
+		child->parent = parent;
+
+		xml_node_struct* prev = node->prev_sibling_c;
+
+		if (prev->next_sibling)
+			prev->next_sibling = child;
+		else
+			parent->first_child = child;
+
+		child->prev_sibling_c = prev;
+		child->next_sibling = node;
+
+		node->prev_sibling_c = child;
+	}
+
+	inline void remove_node(xml_node_struct* node)
+	{
+		xml_node_struct* parent = node->parent;
+
+		xml_node_struct* next = node->next_sibling;
+		xml_node_struct* prev = node->prev_sibling_c;
+
+		if (next)
+			next->prev_sibling_c = prev;
+		else
+			parent->first_child->prev_sibling_c = prev;
+
+		if (prev->next_sibling)
+			prev->next_sibling = next;
+		else
+			parent->first_child = next;
+
+		node->parent = 0;
+		node->prev_sibling_c = 0;
+		node->next_sibling = 0;
+	}
+
+	inline void append_attribute(xml_attribute_struct* attr, xml_node_struct* node)
+	{
+		xml_attribute_struct* head = node->first_attribute;
+
+		if (head)
+		{
+			xml_attribute_struct* tail = head->prev_attribute_c;
+
+			tail->next_attribute = attr;
+			attr->prev_attribute_c = tail;
+			head->prev_attribute_c = attr;
+		}
+		else
+		{
+			node->first_attribute = attr;
+			attr->prev_attribute_c = attr;
+		}
+	}
+
+	inline void prepend_attribute(xml_attribute_struct* attr, xml_node_struct* node)
+	{
+		xml_attribute_struct* head = node->first_attribute;
+
+		if (head)
+		{
+			attr->prev_attribute_c = head->prev_attribute_c;
+			head->prev_attribute_c = attr;
+		}
+		else
+			attr->prev_attribute_c = attr;
+
+		attr->next_attribute = head;
+		node->first_attribute = attr;
+	}
+
+	inline void insert_attribute_after(xml_attribute_struct* attr, xml_attribute_struct* place, xml_node_struct* node)
+	{
+		xml_attribute_struct* next = place->next_attribute;
+
+		if (next)
+			next->prev_attribute_c = attr;
+		else
+			node->first_attribute->prev_attribute_c = attr;
+
+		attr->next_attribute = next;
+		attr->prev_attribute_c = place;
+		place->next_attribute = attr;
+	}
+
+	inline void insert_attribute_before(xml_attribute_struct* attr, xml_attribute_struct* place, xml_node_struct* node)
+	{
+		xml_attribute_struct* prev = place->prev_attribute_c;
+
+		if (prev->next_attribute)
+			prev->next_attribute = attr;
+		else
+			node->first_attribute = attr;
+
+		attr->prev_attribute_c = prev;
+		attr->next_attribute = place;
+		place->prev_attribute_c = attr;
+	}
+
+	inline void remove_attribute(xml_attribute_struct* attr, xml_node_struct* node)
+	{
+		xml_attribute_struct* next = attr->next_attribute;
+		xml_attribute_struct* prev = attr->prev_attribute_c;
+
+		if (next)
+			next->prev_attribute_c = prev;
+		else
+			node->first_attribute->prev_attribute_c = prev;
+
+		if (prev->next_attribute)
+			prev->next_attribute = next;
+		else
+			node->first_attribute = next;
+
+		attr->prev_attribute_c = 0;
+		attr->next_attribute = 0;
+	}
+
+	PUGI_IMPL_FN_NO_INLINE xml_node_struct* append_new_node(xml_node_struct* node, xml_allocator& alloc, xml_node_type type = node_element)
+	{
+		if (!alloc.reserve()) return 0;
+
+		xml_node_struct* child = allocate_node(alloc, type);
+		if (!child) return 0;
+
+		append_node(child, node);
+
+		return child;
+	}
+
+	PUGI_IMPL_FN_NO_INLINE xml_attribute_struct* append_new_attribute(xml_node_struct* node, xml_allocator& alloc)
+	{
+		if (!alloc.reserve()) return 0;
+
+		xml_attribute_struct* attr = allocate_attribute(alloc);
+		if (!attr) return 0;
+
+		append_attribute(attr, node);
+
+		return attr;
+	}
+PUGI_IMPL_NS_END
+
+// Helper classes for code generation
+PUGI_IMPL_NS_BEGIN
+	struct opt_false
+	{
+		enum { value = 0 };
+	};
+
+	struct opt_true
+	{
+		enum { value = 1 };
+	};
+PUGI_IMPL_NS_END
+
+// Unicode utilities
+PUGI_IMPL_NS_BEGIN
+	inline uint16_t endian_swap(uint16_t value)
+	{
+		return static_cast<uint16_t>(((value & 0xff) << 8) | (value >> 8));
+	}
+
+	inline uint32_t endian_swap(uint32_t value)
+	{
+		return ((value & 0xff) << 24) | ((value & 0xff00) << 8) | ((value & 0xff0000) >> 8) | (value >> 24);
+	}
+
+	struct utf8_counter
+	{
+		typedef size_t value_type;
+
+		static value_type low(value_type result, uint32_t ch)
+		{
+			// U+0000..U+007F
+			if (ch < 0x80) return result + 1;
+			// U+0080..U+07FF
+			else if (ch < 0x800) return result + 2;
+			// U+0800..U+FFFF
+			else return result + 3;
+		}
+
+		static value_type high(value_type result, uint32_t)
+		{
+			// U+10000..U+10FFFF
+			return result + 4;
+		}
+	};
+
+	struct utf8_writer
+	{
+		typedef uint8_t* value_type;
+
+		static value_type low(value_type result, uint32_t ch)
+		{
+			// U+0000..U+007F
+			if (ch < 0x80)
+			{
+				*result = static_cast<uint8_t>(ch);
+				return result + 1;
+			}
+			// U+0080..U+07FF
+			else if (ch < 0x800)
+			{
+				result[0] = static_cast<uint8_t>(0xC0 | (ch >> 6));
+				result[1] = static_cast<uint8_t>(0x80 | (ch & 0x3F));
+				return result + 2;
+			}
+			// U+0800..U+FFFF
+			else
+			{
+				result[0] = static_cast<uint8_t>(0xE0 | (ch >> 12));
+				result[1] = static_cast<uint8_t>(0x80 | ((ch >> 6) & 0x3F));
+				result[2] = static_cast<uint8_t>(0x80 | (ch & 0x3F));
+				return result + 3;
+			}
+		}
+
+		static value_type high(value_type result, uint32_t ch)
+		{
+			// U+10000..U+10FFFF
+			result[0] = static_cast<uint8_t>(0xF0 | (ch >> 18));
+			result[1] = static_cast<uint8_t>(0x80 | ((ch >> 12) & 0x3F));
+			result[2] = static_cast<uint8_t>(0x80 | ((ch >> 6) & 0x3F));
+			result[3] = static_cast<uint8_t>(0x80 | (ch & 0x3F));
+			return result + 4;
+		}
+
+		static value_type any(value_type result, uint32_t ch)
+		{
+			return (ch < 0x10000) ? low(result, ch) : high(result, ch);
+		}
+	};
+
+	struct utf16_counter
+	{
+		typedef size_t value_type;
+
+		static value_type low(value_type result, uint32_t)
+		{
+			return result + 1;
+		}
+
+		static value_type high(value_type result, uint32_t)
+		{
+			return result + 2;
+		}
+	};
+
+	struct utf16_writer
+	{
+		typedef uint16_t* value_type;
+
+		static value_type low(value_type result, uint32_t ch)
+		{
+			*result = static_cast<uint16_t>(ch);
+
+			return result + 1;
+		}
+
+		static value_type high(value_type result, uint32_t ch)
+		{
+			uint32_t msh = static_cast<uint32_t>(ch - 0x10000) >> 10;
+			uint32_t lsh = static_cast<uint32_t>(ch - 0x10000) & 0x3ff;
+
+			result[0] = static_cast<uint16_t>(0xD800 + msh);
+			result[1] = static_cast<uint16_t>(0xDC00 + lsh);
+
+			return result + 2;
+		}
+
+		static value_type any(value_type result, uint32_t ch)
+		{
+			return (ch < 0x10000) ? low(result, ch) : high(result, ch);
+		}
+	};
+
+	struct utf32_counter
+	{
+		typedef size_t value_type;
+
+		static value_type low(value_type result, uint32_t)
+		{
+			return result + 1;
+		}
+
+		static value_type high(value_type result, uint32_t)
+		{
+			return result + 1;
+		}
+	};
+
+	struct utf32_writer
+	{
+		typedef uint32_t* value_type;
+
+		static value_type low(value_type result, uint32_t ch)
+		{
+			*result = ch;
+
+			return result + 1;
+		}
+
+		static value_type high(value_type result, uint32_t ch)
+		{
+			*result = ch;
+
+			return result + 1;
+		}
+
+		static value_type any(value_type result, uint32_t ch)
+		{
+			*result = ch;
+
+			return result + 1;
+		}
+	};
+
+	struct latin1_writer
+	{
+		typedef uint8_t* value_type;
+
+		static value_type low(value_type result, uint32_t ch)
+		{
+			*result = static_cast<uint8_t>(ch > 255 ? '?' : ch);
+
+			return result + 1;
+		}
+
+		static value_type high(value_type result, uint32_t ch)
+		{
+			(void)ch;
+
+			*result = '?';
+
+			return result + 1;
+		}
+	};
+
+	struct utf8_decoder
+	{
+		typedef uint8_t type;
+
+		template <typename Traits> static inline typename Traits::value_type process(const uint8_t* data, size_t size, typename Traits::value_type result, Traits)
+		{
+			const uint8_t utf8_byte_mask = 0x3f;
+
+			while (size)
+			{
+				uint8_t lead = *data;
+
+				// 0xxxxxxx -> U+0000..U+007F
+				if (lead < 0x80)
+				{
+					result = Traits::low(result, lead);
+					data += 1;
+					size -= 1;
+
+					// process aligned single-byte (ascii) blocks
+					if ((reinterpret_cast<uintptr_t>(data) & 3) == 0)
+					{
+						// round-trip through void* to silence 'cast increases required alignment of target type' warnings
+						while (size >= 4 && (*static_cast<const uint32_t*>(static_cast<const void*>(data)) & 0x80808080) == 0)
+						{
+							result = Traits::low(result, data[0]);
+							result = Traits::low(result, data[1]);
+							result = Traits::low(result, data[2]);
+							result = Traits::low(result, data[3]);
+							data += 4;
+							size -= 4;
+						}
+					}
+				}
+				// 110xxxxx -> U+0080..U+07FF
+				else if (static_cast<unsigned int>(lead - 0xC0) < 0x20 && size >= 2 && (data[1] & 0xc0) == 0x80)
+				{
+					result = Traits::low(result, ((lead & ~0xC0) << 6) | (data[1] & utf8_byte_mask));
+					data += 2;
+					size -= 2;
+				}
+				// 1110xxxx -> U+0800-U+FFFF
+				else if (static_cast<unsigned int>(lead - 0xE0) < 0x10 && size >= 3 && (data[1] & 0xc0) == 0x80 && (data[2] & 0xc0) == 0x80)
+				{
+					result = Traits::low(result, ((lead & ~0xE0) << 12) | ((data[1] & utf8_byte_mask) << 6) | (data[2] & utf8_byte_mask));
+					data += 3;
+					size -= 3;
+				}
+				// 11110xxx -> U+10000..U+10FFFF
+				else if (static_cast<unsigned int>(lead - 0xF0) < 0x08 && size >= 4 && (data[1] & 0xc0) == 0x80 && (data[2] & 0xc0) == 0x80 && (data[3] & 0xc0) == 0x80)
+				{
+					result = Traits::high(result, ((lead & ~0xF0) << 18) | ((data[1] & utf8_byte_mask) << 12) | ((data[2] & utf8_byte_mask) << 6) | (data[3] & utf8_byte_mask));
+					data += 4;
+					size -= 4;
+				}
+				// 10xxxxxx or 11111xxx -> invalid
+				else
+				{
+					data += 1;
+					size -= 1;
+				}
+			}
+
+			return result;
+		}
+	};
+
+	template <typename opt_swap> struct utf16_decoder
+	{
+		typedef uint16_t type;
+
+		template <typename Traits> static inline typename Traits::value_type process(const uint16_t* data, size_t size, typename Traits::value_type result, Traits)
+		{
+			while (size)
+			{
+				uint16_t lead = opt_swap::value ? endian_swap(*data) : *data;
+
+				// U+0000..U+D7FF
+				if (lead < 0xD800)
+				{
+					result = Traits::low(result, lead);
+					data += 1;
+					size -= 1;
+				}
+				// U+E000..U+FFFF
+				else if (static_cast<unsigned int>(lead - 0xE000) < 0x2000)
+				{
+					result = Traits::low(result, lead);
+					data += 1;
+					size -= 1;
+				}
+				// surrogate pair lead
+				else if (static_cast<unsigned int>(lead - 0xD800) < 0x400 && size >= 2)
+				{
+					uint16_t next = opt_swap::value ? endian_swap(data[1]) : data[1];
+
+					if (static_cast<unsigned int>(next - 0xDC00) < 0x400)
+					{
+						result = Traits::high(result, 0x10000 + ((lead & 0x3ff) << 10) + (next & 0x3ff));
+						data += 2;
+						size -= 2;
+					}
+					else
+					{
+						data += 1;
+						size -= 1;
+					}
+				}
+				else
+				{
+					data += 1;
+					size -= 1;
+				}
+			}
+
+			return result;
+		}
+	};
+
+	template <typename opt_swap> struct utf32_decoder
+	{
+		typedef uint32_t type;
+
+		template <typename Traits> static inline typename Traits::value_type process(const uint32_t* data, size_t size, typename Traits::value_type result, Traits)
+		{
+			while (size)
+			{
+				uint32_t lead = opt_swap::value ? endian_swap(*data) : *data;
+
+				// U+0000..U+FFFF
+				if (lead < 0x10000)
+				{
+					result = Traits::low(result, lead);
+					data += 1;
+					size -= 1;
+				}
+				// U+10000..U+10FFFF
+				else
+				{
+					result = Traits::high(result, lead);
+					data += 1;
+					size -= 1;
+				}
+			}
+
+			return result;
+		}
+	};
+
+	struct latin1_decoder
+	{
+		typedef uint8_t type;
+
+		template <typename Traits> static inline typename Traits::value_type process(const uint8_t* data, size_t size, typename Traits::value_type result, Traits)
+		{
+			while (size)
+			{
+				result = Traits::low(result, *data);
+				data += 1;
+				size -= 1;
+			}
+
+			return result;
+		}
+	};
+
+	template <size_t size> struct wchar_selector;
+
+	template <> struct wchar_selector<2>
+	{
+		typedef uint16_t type;
+		typedef utf16_counter counter;
+		typedef utf16_writer writer;
+		typedef utf16_decoder<opt_false> decoder;
+	};
+
+	template <> struct wchar_selector<4>
+	{
+		typedef uint32_t type;
+		typedef utf32_counter counter;
+		typedef utf32_writer writer;
+		typedef utf32_decoder<opt_false> decoder;
+	};
+
+	typedef wchar_selector<sizeof(wchar_t)>::counter wchar_counter;
+	typedef wchar_selector<sizeof(wchar_t)>::writer wchar_writer;
+
+	struct wchar_decoder
+	{
+		typedef wchar_t type;
+
+		template <typename Traits> static inline typename Traits::value_type process(const wchar_t* data, size_t size, typename Traits::value_type result, Traits traits)
+		{
+			typedef wchar_selector<sizeof(wchar_t)>::decoder decoder;
+
+			return decoder::process(reinterpret_cast<const typename decoder::type*>(data), size, result, traits);
+		}
+	};
+
+#ifdef PUGIXML_WCHAR_MODE
+	PUGI_IMPL_FN void convert_wchar_endian_swap(wchar_t* result, const wchar_t* data, size_t length)
+	{
+		for (size_t i = 0; i < length; ++i)
+			result[i] = static_cast<wchar_t>(endian_swap(static_cast<wchar_selector<sizeof(wchar_t)>::type>(data[i])));
+	}
+#endif
+PUGI_IMPL_NS_END
+
+PUGI_IMPL_NS_BEGIN
+	enum chartype_t
+	{
+		ct_parse_pcdata = 1,	// \0, &, \r, <
+		ct_parse_attr = 2,		// \0, &, \r, ', "
+		ct_parse_attr_ws = 4,	// \0, &, \r, ', ", \n, tab
+		ct_space = 8,			// \r, \n, space, tab
+		ct_parse_cdata = 16,	// \0, ], >, \r
+		ct_parse_comment = 32,	// \0, -, >, \r
+		ct_symbol = 64,			// Any symbol > 127, a-z, A-Z, 0-9, _, :, -, .
+		ct_start_symbol = 128	// Any symbol > 127, a-z, A-Z, _, :
+	};
+
+	static const unsigned char chartype_table[256] =
+	{
+		55,  0,   0,   0,   0,   0,   0,   0,      0,   12,  12,  0,   0,   63,  0,   0,   // 0-15
+		0,   0,   0,   0,   0,   0,   0,   0,      0,   0,   0,   0,   0,   0,   0,   0,   // 16-31
+		8,   0,   6,   0,   0,   0,   7,   6,      0,   0,   0,   0,   0,   96,  64,  0,   // 32-47
+		64,  64,  64,  64,  64,  64,  64,  64,     64,  64,  192, 0,   1,   0,   48,  0,   // 48-63
+		0,   192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192, // 64-79
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 0,   0,   16,  0,   192, // 80-95
+		0,   192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192, // 96-111
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 0, 0, 0, 0, 0,           // 112-127
+
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192, // 128+
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192,
+		192, 192, 192, 192, 192, 192, 192, 192,    192, 192, 192, 192, 192, 192, 192, 192
+	};
+
+	enum chartypex_t
+	{
+		ctx_special_pcdata = 1,   // Any symbol >= 0 and < 32 (except \t, \r, \n), &, <, >
+		ctx_special_attr = 2,     // Any symbol >= 0 and < 32, &, <, ", '
+		ctx_start_symbol = 4,	  // Any symbol > 127, a-z, A-Z, _
+		ctx_digit = 8,			  // 0-9
+		ctx_symbol = 16			  // Any symbol > 127, a-z, A-Z, 0-9, _, -, .
+	};
+
+	static const unsigned char chartypex_table[256] =
+	{
+		3,  3,  3,  3,  3,  3,  3,  3,     3,  2,  2,  3,  3,  2,  3,  3,     // 0-15
+		3,  3,  3,  3,  3,  3,  3,  3,     3,  3,  3,  3,  3,  3,  3,  3,     // 16-31
+		0,  0,  2,  0,  0,  0,  3,  2,     0,  0,  0,  0,  0, 16, 16,  0,     // 32-47
+		24, 24, 24, 24, 24, 24, 24, 24,    24, 24, 0,  0,  3,  0,  1,  0,     // 48-63
+
+		0,  20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,    // 64-79
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 0,  0,  0,  0,  20,    // 80-95
+		0,  20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,    // 96-111
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 0,  0,  0,  0,  0,     // 112-127
+
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,    // 128+
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20,
+		20, 20, 20, 20, 20, 20, 20, 20,    20, 20, 20, 20, 20, 20, 20, 20
+	};
+
+#ifdef PUGIXML_WCHAR_MODE
+	#define PUGI_IMPL_IS_CHARTYPE_IMPL(c, ct, table) ((static_cast<unsigned int>(c) < 128 ? table[static_cast<unsigned int>(c)] : table[128]) & (ct))
+#else
+	#define PUGI_IMPL_IS_CHARTYPE_IMPL(c, ct, table) (table[static_cast<unsigned char>(c)] & (ct))
+#endif
+
+	#define PUGI_IMPL_IS_CHARTYPE(c, ct) PUGI_IMPL_IS_CHARTYPE_IMPL(c, ct, chartype_table)
+	#define PUGI_IMPL_IS_CHARTYPEX(c, ct) PUGI_IMPL_IS_CHARTYPE_IMPL(c, ct, chartypex_table)
+
+	PUGI_IMPL_FN bool is_little_endian()
+	{
+		unsigned int ui = 1;
+
+		return *reinterpret_cast<unsigned char*>(&ui) == 1;
+	}
+
+	PUGI_IMPL_FN xml_encoding get_wchar_encoding()
+	{
+		PUGI_IMPL_STATIC_ASSERT(sizeof(wchar_t) == 2 || sizeof(wchar_t) == 4);
+
+		if (sizeof(wchar_t) == 2)
+			return is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+		else
+			return is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+	}
+
+	PUGI_IMPL_FN bool parse_declaration_encoding(const uint8_t* data, size_t size, const uint8_t*& out_encoding, size_t& out_length)
+	{
+	#define PUGI_IMPL_SCANCHAR(ch) { if (offset >= size || data[offset] != ch) return false; offset++; }
+	#define PUGI_IMPL_SCANCHARTYPE(ct) { while (offset < size && PUGI_IMPL_IS_CHARTYPE(data[offset], ct)) offset++; }
+
+		// check if we have a non-empty XML declaration
+		if (size < 6 || !((data[0] == '<') & (data[1] == '?') & (data[2] == 'x') & (data[3] == 'm') & (data[4] == 'l') && PUGI_IMPL_IS_CHARTYPE(data[5], ct_space)))
+			return false;
+
+		// scan XML declaration until the encoding field
+		for (size_t i = 6; i + 1 < size; ++i)
+		{
+			// declaration can not contain ? in quoted values
+			if (data[i] == '?')
+				return false;
+
+			if (data[i] == 'e' && data[i + 1] == 'n')
+			{
+				size_t offset = i;
+
+				// encoding follows the version field which can't contain 'en' so this has to be the encoding if XML is well formed
+				PUGI_IMPL_SCANCHAR('e'); PUGI_IMPL_SCANCHAR('n'); PUGI_IMPL_SCANCHAR('c'); PUGI_IMPL_SCANCHAR('o');
+				PUGI_IMPL_SCANCHAR('d'); PUGI_IMPL_SCANCHAR('i'); PUGI_IMPL_SCANCHAR('n'); PUGI_IMPL_SCANCHAR('g');
+
+				// S? = S?
+				PUGI_IMPL_SCANCHARTYPE(ct_space);
+				PUGI_IMPL_SCANCHAR('=');
+				PUGI_IMPL_SCANCHARTYPE(ct_space);
+
+				// the only two valid delimiters are ' and "
+				uint8_t delimiter = (offset < size && data[offset] == '"') ? '"' : '\'';
+
+				PUGI_IMPL_SCANCHAR(delimiter);
+
+				size_t start = offset;
+
+				out_encoding = data + offset;
+
+				PUGI_IMPL_SCANCHARTYPE(ct_symbol);
+
+				out_length = offset - start;
+
+				PUGI_IMPL_SCANCHAR(delimiter);
+
+				return true;
+			}
+		}
+
+		return false;
+
+	#undef PUGI_IMPL_SCANCHAR
+	#undef PUGI_IMPL_SCANCHARTYPE
+	}
+
+	PUGI_IMPL_FN xml_encoding guess_buffer_encoding(const uint8_t* data, size_t size)
+	{
+		// skip encoding autodetection if input buffer is too small
+		if (size < 4) return encoding_utf8;
+
+		uint8_t d0 = data[0], d1 = data[1], d2 = data[2], d3 = data[3];
+
+		// look for BOM in first few bytes
+		if (d0 == 0 && d1 == 0 && d2 == 0xfe && d3 == 0xff) return encoding_utf32_be;
+		if (d0 == 0xff && d1 == 0xfe && d2 == 0 && d3 == 0) return encoding_utf32_le;
+		if (d0 == 0xfe && d1 == 0xff) return encoding_utf16_be;
+		if (d0 == 0xff && d1 == 0xfe) return encoding_utf16_le;
+		if (d0 == 0xef && d1 == 0xbb && d2 == 0xbf) return encoding_utf8;
+
+		// look for <, <? or <?xm in various encodings
+		if (d0 == 0 && d1 == 0 && d2 == 0 && d3 == 0x3c) return encoding_utf32_be;
+		if (d0 == 0x3c && d1 == 0 && d2 == 0 && d3 == 0) return encoding_utf32_le;
+		if (d0 == 0 && d1 == 0x3c && d2 == 0 && d3 == 0x3f) return encoding_utf16_be;
+		if (d0 == 0x3c && d1 == 0 && d2 == 0x3f && d3 == 0) return encoding_utf16_le;
+
+		// look for utf16 < followed by node name (this may fail, but is better than utf8 since it's zero terminated so early)
+		if (d0 == 0 && d1 == 0x3c) return encoding_utf16_be;
+		if (d0 == 0x3c && d1 == 0) return encoding_utf16_le;
+
+		// no known BOM detected; parse declaration
+		const uint8_t* enc = 0;
+		size_t enc_length = 0;
+
+		if (d0 == 0x3c && d1 == 0x3f && d2 == 0x78 && d3 == 0x6d && parse_declaration_encoding(data, size, enc, enc_length))
+		{
+			// iso-8859-1 (case-insensitive)
+			if (enc_length == 10
+				&& (enc[0] | ' ') == 'i' && (enc[1] | ' ') == 's' && (enc[2] | ' ') == 'o'
+				&& enc[3] == '-' && enc[4] == '8' && enc[5] == '8' && enc[6] == '5' && enc[7] == '9'
+				&& enc[8] == '-' && enc[9] == '1')
+				return encoding_latin1;
+
+			// latin1 (case-insensitive)
+			if (enc_length == 6
+				&& (enc[0] | ' ') == 'l' && (enc[1] | ' ') == 'a' && (enc[2] | ' ') == 't'
+				&& (enc[3] | ' ') == 'i' && (enc[4] | ' ') == 'n'
+				&& enc[5] == '1')
+				return encoding_latin1;
+		}
+
+		return encoding_utf8;
+	}
+
+	PUGI_IMPL_FN xml_encoding get_buffer_encoding(xml_encoding encoding, const void* contents, size_t size)
+	{
+		// replace wchar encoding with utf implementation
+		if (encoding == encoding_wchar) return get_wchar_encoding();
+
+		// replace utf16 encoding with utf16 with specific endianness
+		if (encoding == encoding_utf16) return is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+		// replace utf32 encoding with utf32 with specific endianness
+		if (encoding == encoding_utf32) return is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+		// only do autodetection if no explicit encoding is requested
+		if (encoding != encoding_auto) return encoding;
+
+		// try to guess encoding (based on XML specification, Appendix F.1)
+		const uint8_t* data = static_cast<const uint8_t*>(contents);
+
+		return guess_buffer_encoding(data, size);
+	}
+
+	PUGI_IMPL_FN bool get_mutable_buffer(char_t*& out_buffer, size_t& out_length, const void* contents, size_t size, bool is_mutable)
+	{
+		size_t length = size / sizeof(char_t);
+
+		if (is_mutable)
+		{
+			out_buffer = static_cast<char_t*>(const_cast<void*>(contents));
+			out_length = length;
+		}
+		else
+		{
+			char_t* buffer = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+			if (!buffer) return false;
+
+			if (contents)
+				memcpy(buffer, contents, length * sizeof(char_t));
+			else
+				assert(length == 0);
+
+			buffer[length] = 0;
+
+			out_buffer = buffer;
+			out_length = length + 1;
+		}
+
+		return true;
+	}
+
+#ifdef PUGIXML_WCHAR_MODE
+	PUGI_IMPL_FN bool need_endian_swap_utf(xml_encoding le, xml_encoding re)
+	{
+		return (le == encoding_utf16_be && re == encoding_utf16_le) || (le == encoding_utf16_le && re == encoding_utf16_be) ||
+			   (le == encoding_utf32_be && re == encoding_utf32_le) || (le == encoding_utf32_le && re == encoding_utf32_be);
+	}
+
+	PUGI_IMPL_FN bool convert_buffer_endian_swap(char_t*& out_buffer, size_t& out_length, const void* contents, size_t size, bool is_mutable)
+	{
+		const char_t* data = static_cast<const char_t*>(contents);
+		size_t length = size / sizeof(char_t);
+
+		if (is_mutable)
+		{
+			char_t* buffer = const_cast<char_t*>(data);
+
+			convert_wchar_endian_swap(buffer, data, length);
+
+			out_buffer = buffer;
+			out_length = length;
+		}
+		else
+		{
+			char_t* buffer = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+			if (!buffer) return false;
+
+			convert_wchar_endian_swap(buffer, data, length);
+			buffer[length] = 0;
+
+			out_buffer = buffer;
+			out_length = length + 1;
+		}
+
+		return true;
+	}
+
+	template <typename D> PUGI_IMPL_FN bool convert_buffer_generic(char_t*& out_buffer, size_t& out_length, const void* contents, size_t size, D)
+	{
+		const typename D::type* data = static_cast<const typename D::type*>(contents);
+		size_t data_length = size / sizeof(typename D::type);
+
+		// first pass: get length in wchar_t units
+		size_t length = D::process(data, data_length, 0, wchar_counter());
+
+		// allocate buffer of suitable length
+		char_t* buffer = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+		if (!buffer) return false;
+
+		// second pass: convert utf16 input to wchar_t
+		wchar_writer::value_type obegin = reinterpret_cast<wchar_writer::value_type>(buffer);
+		wchar_writer::value_type oend = D::process(data, data_length, obegin, wchar_writer());
+
+		assert(oend == obegin + length);
+		*oend = 0;
+
+		out_buffer = buffer;
+		out_length = length + 1;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool convert_buffer(char_t*& out_buffer, size_t& out_length, xml_encoding encoding, const void* contents, size_t size, bool is_mutable)
+	{
+		// get native encoding
+		xml_encoding wchar_encoding = get_wchar_encoding();
+
+		// fast path: no conversion required
+		if (encoding == wchar_encoding)
+			return get_mutable_buffer(out_buffer, out_length, contents, size, is_mutable);
+
+		// only endian-swapping is required
+		if (need_endian_swap_utf(encoding, wchar_encoding))
+			return convert_buffer_endian_swap(out_buffer, out_length, contents, size, is_mutable);
+
+		// source encoding is utf8
+		if (encoding == encoding_utf8)
+			return convert_buffer_generic(out_buffer, out_length, contents, size, utf8_decoder());
+
+		// source encoding is utf16
+		if (encoding == encoding_utf16_be || encoding == encoding_utf16_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+			return (native_encoding == encoding) ?
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf16_decoder<opt_false>()) :
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf16_decoder<opt_true>());
+		}
+
+		// source encoding is utf32
+		if (encoding == encoding_utf32_be || encoding == encoding_utf32_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+			return (native_encoding == encoding) ?
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf32_decoder<opt_false>()) :
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf32_decoder<opt_true>());
+		}
+
+		// source encoding is latin1
+		if (encoding == encoding_latin1)
+			return convert_buffer_generic(out_buffer, out_length, contents, size, latin1_decoder());
+
+		assert(false && "Invalid encoding"); // unreachable
+		return false;
+	}
+#else
+	template <typename D> PUGI_IMPL_FN bool convert_buffer_generic(char_t*& out_buffer, size_t& out_length, const void* contents, size_t size, D)
+	{
+		const typename D::type* data = static_cast<const typename D::type*>(contents);
+		size_t data_length = size / sizeof(typename D::type);
+
+		// first pass: get length in utf8 units
+		size_t length = D::process(data, data_length, 0, utf8_counter());
+
+		// allocate buffer of suitable length
+		char_t* buffer = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+		if (!buffer) return false;
+
+		// second pass: convert utf16 input to utf8
+		uint8_t* obegin = reinterpret_cast<uint8_t*>(buffer);
+		uint8_t* oend = D::process(data, data_length, obegin, utf8_writer());
+
+		assert(oend == obegin + length);
+		*oend = 0;
+
+		out_buffer = buffer;
+		out_length = length + 1;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN size_t get_latin1_7bit_prefix_length(const uint8_t* data, size_t size)
+	{
+		for (size_t i = 0; i < size; ++i)
+			if (data[i] > 127)
+				return i;
+
+		return size;
+	}
+
+	PUGI_IMPL_FN bool convert_buffer_latin1(char_t*& out_buffer, size_t& out_length, const void* contents, size_t size, bool is_mutable)
+	{
+		const uint8_t* data = static_cast<const uint8_t*>(contents);
+		size_t data_length = size;
+
+		// get size of prefix that does not need utf8 conversion
+		size_t prefix_length = get_latin1_7bit_prefix_length(data, data_length);
+		assert(prefix_length <= data_length);
+
+		const uint8_t* postfix = data + prefix_length;
+		size_t postfix_length = data_length - prefix_length;
+
+		// if no conversion is needed, just return the original buffer
+		if (postfix_length == 0) return get_mutable_buffer(out_buffer, out_length, contents, size, is_mutable);
+
+		// first pass: get length in utf8 units
+		size_t length = prefix_length + latin1_decoder::process(postfix, postfix_length, 0, utf8_counter());
+
+		// allocate buffer of suitable length
+		char_t* buffer = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+		if (!buffer) return false;
+
+		// second pass: convert latin1 input to utf8
+		memcpy(buffer, data, prefix_length);
+
+		uint8_t* obegin = reinterpret_cast<uint8_t*>(buffer);
+		uint8_t* oend = latin1_decoder::process(postfix, postfix_length, obegin + prefix_length, utf8_writer());
+
+		assert(oend == obegin + length);
+		*oend = 0;
+
+		out_buffer = buffer;
+		out_length = length + 1;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool convert_buffer(char_t*& out_buffer, size_t& out_length, xml_encoding encoding, const void* contents, size_t size, bool is_mutable)
+	{
+		// fast path: no conversion required
+		if (encoding == encoding_utf8)
+			return get_mutable_buffer(out_buffer, out_length, contents, size, is_mutable);
+
+		// source encoding is utf16
+		if (encoding == encoding_utf16_be || encoding == encoding_utf16_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+			return (native_encoding == encoding) ?
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf16_decoder<opt_false>()) :
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf16_decoder<opt_true>());
+		}
+
+		// source encoding is utf32
+		if (encoding == encoding_utf32_be || encoding == encoding_utf32_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+			return (native_encoding == encoding) ?
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf32_decoder<opt_false>()) :
+				convert_buffer_generic(out_buffer, out_length, contents, size, utf32_decoder<opt_true>());
+		}
+
+		// source encoding is latin1
+		if (encoding == encoding_latin1)
+			return convert_buffer_latin1(out_buffer, out_length, contents, size, is_mutable);
+
+		assert(false && "Invalid encoding"); // unreachable
+		return false;
+	}
+#endif
+
+	PUGI_IMPL_FN size_t as_utf8_begin(const wchar_t* str, size_t length)
+	{
+		// get length in utf8 characters
+		return wchar_decoder::process(str, length, 0, utf8_counter());
+	}
+
+	PUGI_IMPL_FN void as_utf8_end(char* buffer, size_t size, const wchar_t* str, size_t length)
+	{
+		// convert to utf8
+		uint8_t* begin = reinterpret_cast<uint8_t*>(buffer);
+		uint8_t* end = wchar_decoder::process(str, length, begin, utf8_writer());
+
+		assert(begin + size == end);
+		(void)!end;
+		(void)!size;
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN std::string as_utf8_impl(const wchar_t* str, size_t length)
+	{
+		// first pass: get length in utf8 characters
+		size_t size = as_utf8_begin(str, length);
+
+		// allocate resulting string
+		std::string result;
+		result.resize(size);
+
+		// second pass: convert to utf8
+		if (size > 0) as_utf8_end(&result[0], size, str, length);
+
+		return result;
+	}
+
+	PUGI_IMPL_FN std::basic_string<wchar_t> as_wide_impl(const char* str, size_t size)
+	{
+		const uint8_t* data = reinterpret_cast<const uint8_t*>(str);
+
+		// first pass: get length in wchar_t units
+		size_t length = utf8_decoder::process(data, size, 0, wchar_counter());
+
+		// allocate resulting string
+		std::basic_string<wchar_t> result;
+		result.resize(length);
+
+		// second pass: convert to wchar_t
+		if (length > 0)
+		{
+			wchar_writer::value_type begin = reinterpret_cast<wchar_writer::value_type>(&result[0]);
+			wchar_writer::value_type end = utf8_decoder::process(data, size, begin, wchar_writer());
+
+			assert(begin + length == end);
+			(void)!end;
+		}
+
+		return result;
+	}
+#endif
+
+	template <typename Header>
+	inline bool strcpy_insitu_allow(size_t length, const Header& header, uintptr_t header_mask, char_t* target)
+	{
+		// never reuse shared memory
+		if (header & xml_memory_page_contents_shared_mask) return false;
+
+		size_t target_length = strlength(target);
+
+		// always reuse document buffer memory if possible
+		if ((header & header_mask) == 0) return target_length >= length;
+
+		// reuse heap memory if waste is not too great
+		const size_t reuse_threshold = 32;
+
+		return target_length >= length && (target_length < reuse_threshold || target_length - length < target_length / 2);
+	}
+
+	template <typename String, typename Header>
+	PUGI_IMPL_FN bool strcpy_insitu(String& dest, Header& header, uintptr_t header_mask, const char_t* source, size_t source_length)
+	{
+		assert((header & header_mask) == 0 || dest); // header bit indicates whether dest was previously allocated
+
+		if (source_length == 0)
+		{
+			// empty string and null pointer are equivalent, so just deallocate old memory
+			xml_allocator* alloc = PUGI_IMPL_GETPAGE_IMPL(header)->allocator;
+
+			if (header & header_mask) alloc->deallocate_string(dest);
+
+			// mark the string as not allocated
+			dest = 0;
+			header &= ~header_mask;
+
+			return true;
+		}
+		else if (dest && strcpy_insitu_allow(source_length, header, header_mask, dest))
+		{
+			// we can reuse old buffer, so just copy the new data (including zero terminator)
+			memcpy(dest, source, source_length * sizeof(char_t));
+			dest[source_length] = 0;
+
+			return true;
+		}
+		else
+		{
+			xml_allocator* alloc = PUGI_IMPL_GETPAGE_IMPL(header)->allocator;
+
+			if (!alloc->reserve()) return false;
+
+			// allocate new buffer
+			char_t* buf = alloc->allocate_string(source_length + 1);
+			if (!buf) return false;
+
+			// copy the string (including zero terminator)
+			memcpy(buf, source, source_length * sizeof(char_t));
+			buf[source_length] = 0;
+
+			// deallocate old buffer (*after* the above to protect against overlapping memory and/or allocation failures)
+			if (header & header_mask) alloc->deallocate_string(dest);
+
+			// the string is now allocated, so set the flag
+			dest = buf;
+			header |= header_mask;
+
+			return true;
+		}
+	}
+
+	struct gap
+	{
+		char_t* end;
+		size_t size;
+
+		gap(): end(0), size(0)
+		{
+		}
+
+		// Push new gap, move s count bytes further (skipping the gap).
+		// Collapse previous gap.
+		void push(char_t*& s, size_t count)
+		{
+			if (end) // there was a gap already; collapse it
+			{
+				// Move [old_gap_end, new_gap_start) to [old_gap_start, ...)
+				assert(s >= end);
+				memmove(end - size, end, reinterpret_cast<char*>(s) - reinterpret_cast<char*>(end));
+			}
+
+			s += count; // end of current gap
+
+			// "merge" two gaps
+			end = s;
+			size += count;
+		}
+
+		// Collapse all gaps, return past-the-end pointer
+		char_t* flush(char_t* s)
+		{
+			if (end)
+			{
+				// Move [old_gap_end, current_pos) to [old_gap_start, ...)
+				assert(s >= end);
+				memmove(end - size, end, reinterpret_cast<char*>(s) - reinterpret_cast<char*>(end));
+
+				return s - size;
+			}
+			else return s;
+		}
+	};
+
+	PUGI_IMPL_FN char_t* strconv_escape(char_t* s, gap& g)
+	{
+		char_t* stre = s + 1;
+
+		switch (*stre)
+		{
+			case '#':	// &#...
+			{
+				unsigned int ucsc = 0;
+
+				if (stre[1] == 'x') // &#x... (hex code)
+				{
+					stre += 2;
+
+					char_t ch = *stre;
+
+					if (ch == ';') return stre;
+
+					for (;;)
+					{
+						if (static_cast<unsigned int>(ch - '0') <= 9)
+							ucsc = 16 * ucsc + (ch - '0');
+						else if (static_cast<unsigned int>((ch | ' ') - 'a') <= 5)
+							ucsc = 16 * ucsc + ((ch | ' ') - 'a' + 10);
+						else if (ch == ';')
+							break;
+						else // cancel
+							return stre;
+
+						ch = *++stre;
+					}
+
+					++stre;
+				}
+				else	// &#... (dec code)
+				{
+					char_t ch = *++stre;
+
+					if (ch == ';') return stre;
+
+					for (;;)
+					{
+						if (static_cast<unsigned int>(ch - '0') <= 9)
+							ucsc = 10 * ucsc + (ch - '0');
+						else if (ch == ';')
+							break;
+						else // cancel
+							return stre;
+
+						ch = *++stre;
+					}
+
+					++stre;
+				}
+
+			#ifdef PUGIXML_WCHAR_MODE
+				s = reinterpret_cast<char_t*>(wchar_writer::any(reinterpret_cast<wchar_writer::value_type>(s), ucsc));
+			#else
+				s = reinterpret_cast<char_t*>(utf8_writer::any(reinterpret_cast<uint8_t*>(s), ucsc));
+			#endif
+
+				g.push(s, stre - s);
+				return stre;
+			}
+
+			case 'a':	// &a
+			{
+				++stre;
+
+				if (*stre == 'm') // &am
+				{
+					if (*++stre == 'p' && *++stre == ';') // &amp;
+					{
+						*s++ = '&';
+						++stre;
+
+						g.push(s, stre - s);
+						return stre;
+					}
+				}
+				else if (*stre == 'p') // &ap
+				{
+					if (*++stre == 'o' && *++stre == 's' && *++stre == ';') // &apos;
+					{
+						*s++ = '\'';
+						++stre;
+
+						g.push(s, stre - s);
+						return stre;
+					}
+				}
+				break;
+			}
+
+			case 'g': // &g
+			{
+				if (*++stre == 't' && *++stre == ';') // &gt;
+				{
+					*s++ = '>';
+					++stre;
+
+					g.push(s, stre - s);
+					return stre;
+				}
+				break;
+			}
+
+			case 'l': // &l
+			{
+				if (*++stre == 't' && *++stre == ';') // &lt;
+				{
+					*s++ = '<';
+					++stre;
+
+					g.push(s, stre - s);
+					return stre;
+				}
+				break;
+			}
+
+			case 'q': // &q
+			{
+				if (*++stre == 'u' && *++stre == 'o' && *++stre == 't' && *++stre == ';') // &quot;
+				{
+					*s++ = '"';
+					++stre;
+
+					g.push(s, stre - s);
+					return stre;
+				}
+				break;
+			}
+
+			default:
+				break;
+		}
+
+		return stre;
+	}
+
+	// Parser utilities
+	#define PUGI_IMPL_ENDSWITH(c, e)        ((c) == (e) || ((c) == 0 && endch == (e)))
+	#define PUGI_IMPL_SKIPWS()              { while (PUGI_IMPL_IS_CHARTYPE(*s, ct_space)) ++s; }
+	#define PUGI_IMPL_OPTSET(OPT)           ( optmsk & (OPT) )
+	#define PUGI_IMPL_PUSHNODE(TYPE)        { cursor = append_new_node(cursor, *alloc, TYPE); if (!cursor) PUGI_IMPL_THROW_ERROR(status_out_of_memory, s); }
+	#define PUGI_IMPL_POPNODE()             { cursor = cursor->parent; }
+	#define PUGI_IMPL_SCANFOR(X)            { while (*s != 0 && !(X)) ++s; }
+	#define PUGI_IMPL_SCANWHILE(X)          { while (X) ++s; }
+	#define PUGI_IMPL_SCANWHILE_UNROLL(X)   { for (;;) { char_t ss = s[0]; if (PUGI_IMPL_UNLIKELY(!(X))) { break; } ss = s[1]; if (PUGI_IMPL_UNLIKELY(!(X))) { s += 1; break; } ss = s[2]; if (PUGI_IMPL_UNLIKELY(!(X))) { s += 2; break; } ss = s[3]; if (PUGI_IMPL_UNLIKELY(!(X))) { s += 3; break; } s += 4; } }
+	#define PUGI_IMPL_ENDSEG()              { ch = *s; *s = 0; ++s; }
+	#define PUGI_IMPL_THROW_ERROR(err, m)   return error_offset = m, error_status = err, static_cast<char_t*>(0)
+	#define PUGI_IMPL_CHECK_ERROR(err, m)   { if (*s == 0) PUGI_IMPL_THROW_ERROR(err, m); }
+
+	PUGI_IMPL_FN char_t* strconv_comment(char_t* s, char_t endch)
+	{
+		gap g;
+
+		while (true)
+		{
+			PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_comment));
+
+			if (*s == '\r') // Either a single 0x0d or 0x0d 0x0a pair
+			{
+				*s++ = '\n'; // replace first one with 0x0a
+
+				if (*s == '\n') g.push(s, 1);
+			}
+			else if (s[0] == '-' && s[1] == '-' && PUGI_IMPL_ENDSWITH(s[2], '>')) // comment ends here
+			{
+				*g.flush(s) = 0;
+
+				return s + (s[2] == '>' ? 3 : 2);
+			}
+			else if (*s == 0)
+			{
+				return 0;
+			}
+			else ++s;
+		}
+	}
+
+	PUGI_IMPL_FN char_t* strconv_cdata(char_t* s, char_t endch)
+	{
+		gap g;
+
+		while (true)
+		{
+			PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_cdata));
+
+			if (*s == '\r') // Either a single 0x0d or 0x0d 0x0a pair
+			{
+				*s++ = '\n'; // replace first one with 0x0a
+
+				if (*s == '\n') g.push(s, 1);
+			}
+			else if (s[0] == ']' && s[1] == ']' && PUGI_IMPL_ENDSWITH(s[2], '>')) // CDATA ends here
+			{
+				*g.flush(s) = 0;
+
+				return s + 1;
+			}
+			else if (*s == 0)
+			{
+				return 0;
+			}
+			else ++s;
+		}
+	}
+
+	typedef char_t* (*strconv_pcdata_t)(char_t*);
+
+	template <typename opt_trim, typename opt_eol, typename opt_escape> struct strconv_pcdata_impl
+	{
+		static char_t* parse(char_t* s)
+		{
+			gap g;
+
+			char_t* begin = s;
+
+			while (true)
+			{
+				PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_pcdata));
+
+				if (*s == '<') // PCDATA ends here
+				{
+					char_t* end = g.flush(s);
+
+					if (opt_trim::value)
+						while (end > begin && PUGI_IMPL_IS_CHARTYPE(end[-1], ct_space))
+							--end;
+
+					*end = 0;
+
+					return s + 1;
+				}
+				else if (opt_eol::value && *s == '\r') // Either a single 0x0d or 0x0d 0x0a pair
+				{
+					*s++ = '\n'; // replace first one with 0x0a
+
+					if (*s == '\n') g.push(s, 1);
+				}
+				else if (opt_escape::value && *s == '&')
+				{
+					s = strconv_escape(s, g);
+				}
+				else if (*s == 0)
+				{
+					char_t* end = g.flush(s);
+
+					if (opt_trim::value)
+						while (end > begin && PUGI_IMPL_IS_CHARTYPE(end[-1], ct_space))
+							--end;
+
+					*end = 0;
+
+					return s;
+				}
+				else ++s;
+			}
+		}
+	};
+
+	PUGI_IMPL_FN strconv_pcdata_t get_strconv_pcdata(unsigned int optmask)
+	{
+		PUGI_IMPL_STATIC_ASSERT(parse_escapes == 0x10 && parse_eol == 0x20 && parse_trim_pcdata == 0x0800);
+
+		switch (((optmask >> 4) & 3) | ((optmask >> 9) & 4)) // get bitmask for flags (trim eol escapes); this simultaneously checks 3 options from assertion above
+		{
+		case 0: return strconv_pcdata_impl<opt_false, opt_false, opt_false>::parse;
+		case 1: return strconv_pcdata_impl<opt_false, opt_false, opt_true>::parse;
+		case 2: return strconv_pcdata_impl<opt_false, opt_true, opt_false>::parse;
+		case 3: return strconv_pcdata_impl<opt_false, opt_true, opt_true>::parse;
+		case 4: return strconv_pcdata_impl<opt_true, opt_false, opt_false>::parse;
+		case 5: return strconv_pcdata_impl<opt_true, opt_false, opt_true>::parse;
+		case 6: return strconv_pcdata_impl<opt_true, opt_true, opt_false>::parse;
+		case 7: return strconv_pcdata_impl<opt_true, opt_true, opt_true>::parse;
+		default: assert(false); return 0; // unreachable
+		}
+	}
+
+	typedef char_t* (*strconv_attribute_t)(char_t*, char_t);
+
+	template <typename opt_escape> struct strconv_attribute_impl
+	{
+		static char_t* parse_wnorm(char_t* s, char_t end_quote)
+		{
+			gap g;
+
+			// trim leading whitespaces
+			if (PUGI_IMPL_IS_CHARTYPE(*s, ct_space))
+			{
+				char_t* str = s;
+
+				do ++str;
+				while (PUGI_IMPL_IS_CHARTYPE(*str, ct_space));
+
+				g.push(s, str - s);
+			}
+
+			while (true)
+			{
+				PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_attr_ws | ct_space));
+
+				if (*s == end_quote)
+				{
+					char_t* str = g.flush(s);
+
+					do *str-- = 0;
+					while (PUGI_IMPL_IS_CHARTYPE(*str, ct_space));
+
+					return s + 1;
+				}
+				else if (PUGI_IMPL_IS_CHARTYPE(*s, ct_space))
+				{
+					*s++ = ' ';
+
+					if (PUGI_IMPL_IS_CHARTYPE(*s, ct_space))
+					{
+						char_t* str = s + 1;
+						while (PUGI_IMPL_IS_CHARTYPE(*str, ct_space)) ++str;
+
+						g.push(s, str - s);
+					}
+				}
+				else if (opt_escape::value && *s == '&')
+				{
+					s = strconv_escape(s, g);
+				}
+				else if (!*s)
+				{
+					return 0;
+				}
+				else ++s;
+			}
+		}
+
+		static char_t* parse_wconv(char_t* s, char_t end_quote)
+		{
+			gap g;
+
+			while (true)
+			{
+				PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_attr_ws));
+
+				if (*s == end_quote)
+				{
+					*g.flush(s) = 0;
+
+					return s + 1;
+				}
+				else if (PUGI_IMPL_IS_CHARTYPE(*s, ct_space))
+				{
+					if (*s == '\r')
+					{
+						*s++ = ' ';
+
+						if (*s == '\n') g.push(s, 1);
+					}
+					else *s++ = ' ';
+				}
+				else if (opt_escape::value && *s == '&')
+				{
+					s = strconv_escape(s, g);
+				}
+				else if (!*s)
+				{
+					return 0;
+				}
+				else ++s;
+			}
+		}
+
+		static char_t* parse_eol(char_t* s, char_t end_quote)
+		{
+			gap g;
+
+			while (true)
+			{
+				PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_attr));
+
+				if (*s == end_quote)
+				{
+					*g.flush(s) = 0;
+
+					return s + 1;
+				}
+				else if (*s == '\r')
+				{
+					*s++ = '\n';
+
+					if (*s == '\n') g.push(s, 1);
+				}
+				else if (opt_escape::value && *s == '&')
+				{
+					s = strconv_escape(s, g);
+				}
+				else if (!*s)
+				{
+					return 0;
+				}
+				else ++s;
+			}
+		}
+
+		static char_t* parse_simple(char_t* s, char_t end_quote)
+		{
+			gap g;
+
+			while (true)
+			{
+				PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPE(ss, ct_parse_attr));
+
+				if (*s == end_quote)
+				{
+					*g.flush(s) = 0;
+
+					return s + 1;
+				}
+				else if (opt_escape::value && *s == '&')
+				{
+					s = strconv_escape(s, g);
+				}
+				else if (!*s)
+				{
+					return 0;
+				}
+				else ++s;
+			}
+		}
+	};
+
+	PUGI_IMPL_FN strconv_attribute_t get_strconv_attribute(unsigned int optmask)
+	{
+		PUGI_IMPL_STATIC_ASSERT(parse_escapes == 0x10 && parse_eol == 0x20 && parse_wconv_attribute == 0x40 && parse_wnorm_attribute == 0x80);
+
+		switch ((optmask >> 4) & 15) // get bitmask for flags (wnorm wconv eol escapes); this simultaneously checks 4 options from assertion above
+		{
+		case 0:  return strconv_attribute_impl<opt_false>::parse_simple;
+		case 1:  return strconv_attribute_impl<opt_true>::parse_simple;
+		case 2:  return strconv_attribute_impl<opt_false>::parse_eol;
+		case 3:  return strconv_attribute_impl<opt_true>::parse_eol;
+		case 4:  return strconv_attribute_impl<opt_false>::parse_wconv;
+		case 5:  return strconv_attribute_impl<opt_true>::parse_wconv;
+		case 6:  return strconv_attribute_impl<opt_false>::parse_wconv;
+		case 7:  return strconv_attribute_impl<opt_true>::parse_wconv;
+		case 8:  return strconv_attribute_impl<opt_false>::parse_wnorm;
+		case 9:  return strconv_attribute_impl<opt_true>::parse_wnorm;
+		case 10: return strconv_attribute_impl<opt_false>::parse_wnorm;
+		case 11: return strconv_attribute_impl<opt_true>::parse_wnorm;
+		case 12: return strconv_attribute_impl<opt_false>::parse_wnorm;
+		case 13: return strconv_attribute_impl<opt_true>::parse_wnorm;
+		case 14: return strconv_attribute_impl<opt_false>::parse_wnorm;
+		case 15: return strconv_attribute_impl<opt_true>::parse_wnorm;
+		default: assert(false); return 0; // unreachable
+		}
+	}
+
+	inline xml_parse_result make_parse_result(xml_parse_status status, ptrdiff_t offset = 0)
+	{
+		xml_parse_result result;
+		result.status = status;
+		result.offset = offset;
+
+		return result;
+	}
+
+	struct xml_parser
+	{
+		xml_allocator* alloc;
+		char_t* error_offset;
+		xml_parse_status error_status;
+
+		xml_parser(xml_allocator* alloc_): alloc(alloc_), error_offset(0), error_status(status_ok)
+		{
+		}
+
+		// DOCTYPE consists of nested sections of the following possible types:
+		// <!-- ... -->, <? ... ?>, "...", '...'
+		// <![...]]>
+		// <!...>
+		// First group can not contain nested groups
+		// Second group can contain nested groups of the same type
+		// Third group can contain all other groups
+		char_t* parse_doctype_primitive(char_t* s)
+		{
+			if (*s == '"' || *s == '\'')
+			{
+				// quoted string
+				char_t ch = *s++;
+				PUGI_IMPL_SCANFOR(*s == ch);
+				if (!*s) PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+				s++;
+			}
+			else if (s[0] == '<' && s[1] == '?')
+			{
+				// <? ... ?>
+				s += 2;
+				PUGI_IMPL_SCANFOR(s[0] == '?' && s[1] == '>'); // no need for ENDSWITH because ?> can't terminate proper doctype
+				if (!*s) PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+				s += 2;
+			}
+			else if (s[0] == '<' && s[1] == '!' && s[2] == '-' && s[3] == '-')
+			{
+				s += 4;
+				PUGI_IMPL_SCANFOR(s[0] == '-' && s[1] == '-' && s[2] == '>'); // no need for ENDSWITH because --> can't terminate proper doctype
+				if (!*s) PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+				s += 3;
+			}
+			else PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+			return s;
+		}
+
+		char_t* parse_doctype_ignore(char_t* s)
+		{
+			size_t depth = 0;
+
+			assert(s[0] == '<' && s[1] == '!' && s[2] == '[');
+			s += 3;
+
+			while (*s)
+			{
+				if (s[0] == '<' && s[1] == '!' && s[2] == '[')
+				{
+					// nested ignore section
+					s += 3;
+					depth++;
+				}
+				else if (s[0] == ']' && s[1] == ']' && s[2] == '>')
+				{
+					// ignore section end
+					s += 3;
+
+					if (depth == 0)
+						return s;
+
+					depth--;
+				}
+				else s++;
+			}
+
+			PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+		}
+
+		char_t* parse_doctype_group(char_t* s, char_t endch)
+		{
+			size_t depth = 0;
+
+			assert((s[0] == '<' || s[0] == 0) && s[1] == '!');
+			s += 2;
+
+			while (*s)
+			{
+				if (s[0] == '<' && s[1] == '!' && s[2] != '-')
+				{
+					if (s[2] == '[')
+					{
+						// ignore
+						s = parse_doctype_ignore(s);
+						if (!s) return s;
+					}
+					else
+					{
+						// some control group
+						s += 2;
+						depth++;
+					}
+				}
+				else if (s[0] == '<' || s[0] == '"' || s[0] == '\'')
+				{
+					// unknown tag (forbidden), or some primitive group
+					s = parse_doctype_primitive(s);
+					if (!s) return s;
+				}
+				else if (*s == '>')
+				{
+					if (depth == 0)
+						return s;
+
+					depth--;
+					s++;
+				}
+				else s++;
+			}
+
+			if (depth != 0 || endch != '>') PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+			return s;
+		}
+
+		char_t* parse_exclamation(char_t* s, xml_node_struct* cursor, unsigned int optmsk, char_t endch)
+		{
+			// parse node contents, starting with exclamation mark
+			++s;
+
+			if (*s == '-') // '<!-...'
+			{
+				++s;
+
+				if (*s == '-') // '<!--...'
+				{
+					++s;
+
+					if (PUGI_IMPL_OPTSET(parse_comments))
+					{
+						PUGI_IMPL_PUSHNODE(node_comment); // Append a new node on the tree.
+						cursor->value = s; // Save the offset.
+					}
+
+					if (PUGI_IMPL_OPTSET(parse_eol) && PUGI_IMPL_OPTSET(parse_comments))
+					{
+						s = strconv_comment(s, endch);
+
+						if (!s) PUGI_IMPL_THROW_ERROR(status_bad_comment, cursor->value);
+					}
+					else
+					{
+						// Scan for terminating '-->'.
+						PUGI_IMPL_SCANFOR(s[0] == '-' && s[1] == '-' && PUGI_IMPL_ENDSWITH(s[2], '>'));
+						PUGI_IMPL_CHECK_ERROR(status_bad_comment, s);
+
+						if (PUGI_IMPL_OPTSET(parse_comments))
+							*s = 0; // Zero-terminate this segment at the first terminating '-'.
+
+						s += (s[2] == '>' ? 3 : 2); // Step over the '\0->'.
+					}
+				}
+				else PUGI_IMPL_THROW_ERROR(status_bad_comment, s);
+			}
+			else if (*s == '[')
+			{
+				// '<![CDATA[...'
+				if (*++s=='C' && *++s=='D' && *++s=='A' && *++s=='T' && *++s=='A' && *++s == '[')
+				{
+					++s;
+
+					if (PUGI_IMPL_OPTSET(parse_cdata))
+					{
+						PUGI_IMPL_PUSHNODE(node_cdata); // Append a new node on the tree.
+						cursor->value = s; // Save the offset.
+
+						if (PUGI_IMPL_OPTSET(parse_eol))
+						{
+							s = strconv_cdata(s, endch);
+
+							if (!s) PUGI_IMPL_THROW_ERROR(status_bad_cdata, cursor->value);
+						}
+						else
+						{
+							// Scan for terminating ']]>'.
+							PUGI_IMPL_SCANFOR(s[0] == ']' && s[1] == ']' && PUGI_IMPL_ENDSWITH(s[2], '>'));
+							PUGI_IMPL_CHECK_ERROR(status_bad_cdata, s);
+
+							*s++ = 0; // Zero-terminate this segment.
+						}
+					}
+					else // Flagged for discard, but we still have to scan for the terminator.
+					{
+						// Scan for terminating ']]>'.
+						PUGI_IMPL_SCANFOR(s[0] == ']' && s[1] == ']' && PUGI_IMPL_ENDSWITH(s[2], '>'));
+						PUGI_IMPL_CHECK_ERROR(status_bad_cdata, s);
+
+						++s;
+					}
+
+					s += (s[1] == '>' ? 2 : 1); // Step over the last ']>'.
+				}
+				else PUGI_IMPL_THROW_ERROR(status_bad_cdata, s);
+			}
+			else if (s[0] == 'D' && s[1] == 'O' && s[2] == 'C' && s[3] == 'T' && s[4] == 'Y' && s[5] == 'P' && PUGI_IMPL_ENDSWITH(s[6], 'E'))
+			{
+				s -= 2;
+
+				if (cursor->parent) PUGI_IMPL_THROW_ERROR(status_bad_doctype, s);
+
+				char_t* mark = s + 9;
+
+				s = parse_doctype_group(s, endch);
+				if (!s) return s;
+
+				assert((*s == 0 && endch == '>') || *s == '>');
+				if (*s) *s++ = 0;
+
+				if (PUGI_IMPL_OPTSET(parse_doctype))
+				{
+					while (PUGI_IMPL_IS_CHARTYPE(*mark, ct_space)) ++mark;
+
+					PUGI_IMPL_PUSHNODE(node_doctype);
+
+					cursor->value = mark;
+				}
+			}
+			else if (*s == 0 && endch == '-') PUGI_IMPL_THROW_ERROR(status_bad_comment, s);
+			else if (*s == 0 && endch == '[') PUGI_IMPL_THROW_ERROR(status_bad_cdata, s);
+			else PUGI_IMPL_THROW_ERROR(status_unrecognized_tag, s);
+
+			return s;
+		}
+
+		char_t* parse_question(char_t* s, xml_node_struct*& ref_cursor, unsigned int optmsk, char_t endch)
+		{
+			// load into registers
+			xml_node_struct* cursor = ref_cursor;
+			char_t ch = 0;
+
+			// parse node contents, starting with question mark
+			++s;
+
+			// read PI target
+			char_t* target = s;
+
+			if (!PUGI_IMPL_IS_CHARTYPE(*s, ct_start_symbol)) PUGI_IMPL_THROW_ERROR(status_bad_pi, s);
+
+			PUGI_IMPL_SCANWHILE(PUGI_IMPL_IS_CHARTYPE(*s, ct_symbol));
+			PUGI_IMPL_CHECK_ERROR(status_bad_pi, s);
+
+			// determine node type; stricmp / strcasecmp is not portable
+			bool declaration = (target[0] | ' ') == 'x' && (target[1] | ' ') == 'm' && (target[2] | ' ') == 'l' && target + 3 == s;
+
+			if (declaration ? PUGI_IMPL_OPTSET(parse_declaration) : PUGI_IMPL_OPTSET(parse_pi))
+			{
+				if (declaration)
+				{
+					// disallow non top-level declarations
+					if (cursor->parent) PUGI_IMPL_THROW_ERROR(status_bad_pi, s);
+
+					PUGI_IMPL_PUSHNODE(node_declaration);
+				}
+				else
+				{
+					PUGI_IMPL_PUSHNODE(node_pi);
+				}
+
+				cursor->name = target;
+
+				PUGI_IMPL_ENDSEG();
+
+				// parse value/attributes
+				if (ch == '?')
+				{
+					// empty node
+					if (!PUGI_IMPL_ENDSWITH(*s, '>')) PUGI_IMPL_THROW_ERROR(status_bad_pi, s);
+					s += (*s == '>');
+
+					PUGI_IMPL_POPNODE();
+				}
+				else if (PUGI_IMPL_IS_CHARTYPE(ch, ct_space))
+				{
+					PUGI_IMPL_SKIPWS();
+
+					// scan for tag end
+					char_t* value = s;
+
+					PUGI_IMPL_SCANFOR(s[0] == '?' && PUGI_IMPL_ENDSWITH(s[1], '>'));
+					PUGI_IMPL_CHECK_ERROR(status_bad_pi, s);
+
+					if (declaration)
+					{
+						// replace ending ? with / so that 'element' terminates properly
+						*s = '/';
+
+						// we exit from this function with cursor at node_declaration, which is a signal to parse() to go to LOC_ATTRIBUTES
+						s = value;
+					}
+					else
+					{
+						// store value and step over >
+						cursor->value = value;
+
+						PUGI_IMPL_POPNODE();
+
+						PUGI_IMPL_ENDSEG();
+
+						s += (*s == '>');
+					}
+				}
+				else PUGI_IMPL_THROW_ERROR(status_bad_pi, s);
+			}
+			else
+			{
+				// scan for tag end
+				PUGI_IMPL_SCANFOR(s[0] == '?' && PUGI_IMPL_ENDSWITH(s[1], '>'));
+				PUGI_IMPL_CHECK_ERROR(status_bad_pi, s);
+
+				s += (s[1] == '>' ? 2 : 1);
+			}
+
+			// store from registers
+			ref_cursor = cursor;
+
+			return s;
+		}
+
+		char_t* parse_tree(char_t* s, xml_node_struct* root, unsigned int optmsk, char_t endch)
+		{
+			strconv_attribute_t strconv_attribute = get_strconv_attribute(optmsk);
+			strconv_pcdata_t strconv_pcdata = get_strconv_pcdata(optmsk);
+
+			char_t ch = 0;
+			xml_node_struct* cursor = root;
+			char_t* mark = s;
+			char_t* merged_pcdata = s;
+
+			while (*s != 0)
+			{
+				if (*s == '<')
+				{
+					++s;
+
+				LOC_TAG:
+					if (PUGI_IMPL_IS_CHARTYPE(*s, ct_start_symbol)) // '<#...'
+					{
+						PUGI_IMPL_PUSHNODE(node_element); // Append a new node to the tree.
+
+						cursor->name = s;
+
+						PUGI_IMPL_SCANWHILE_UNROLL(PUGI_IMPL_IS_CHARTYPE(ss, ct_symbol)); // Scan for a terminator.
+						PUGI_IMPL_ENDSEG(); // Save char in 'ch', terminate & step over.
+
+						if (ch == '>')
+						{
+							// end of tag
+						}
+						else if (PUGI_IMPL_IS_CHARTYPE(ch, ct_space))
+						{
+						LOC_ATTRIBUTES:
+							while (true)
+							{
+								PUGI_IMPL_SKIPWS(); // Eat any whitespace.
+
+								if (PUGI_IMPL_IS_CHARTYPE(*s, ct_start_symbol)) // <... #...
+								{
+									xml_attribute_struct* a = append_new_attribute(cursor, *alloc); // Make space for this attribute.
+									if (!a) PUGI_IMPL_THROW_ERROR(status_out_of_memory, s);
+
+									a->name = s; // Save the offset.
+
+									PUGI_IMPL_SCANWHILE_UNROLL(PUGI_IMPL_IS_CHARTYPE(ss, ct_symbol)); // Scan for a terminator.
+									PUGI_IMPL_ENDSEG(); // Save char in 'ch', terminate & step over.
+
+									if (PUGI_IMPL_IS_CHARTYPE(ch, ct_space))
+									{
+										PUGI_IMPL_SKIPWS(); // Eat any whitespace.
+
+										ch = *s;
+										++s;
+									}
+
+									if (ch == '=') // '<... #=...'
+									{
+										PUGI_IMPL_SKIPWS(); // Eat any whitespace.
+
+										if (*s == '"' || *s == '\'') // '<... #="...'
+										{
+											ch = *s; // Save quote char to avoid breaking on "''" -or- '""'.
+											++s; // Step over the quote.
+											a->value = s; // Save the offset.
+
+											s = strconv_attribute(s, ch);
+
+											if (!s) PUGI_IMPL_THROW_ERROR(status_bad_attribute, a->value);
+
+											// After this line the loop continues from the start;
+											// Whitespaces, / and > are ok, symbols and EOF are wrong,
+											// everything else will be detected
+											if (PUGI_IMPL_IS_CHARTYPE(*s, ct_start_symbol)) PUGI_IMPL_THROW_ERROR(status_bad_attribute, s);
+										}
+										else PUGI_IMPL_THROW_ERROR(status_bad_attribute, s);
+									}
+									else PUGI_IMPL_THROW_ERROR(status_bad_attribute, s);
+								}
+								else if (*s == '/')
+								{
+									++s;
+
+									if (*s == '>')
+									{
+										PUGI_IMPL_POPNODE();
+										s++;
+										break;
+									}
+									else if (*s == 0 && endch == '>')
+									{
+										PUGI_IMPL_POPNODE();
+										break;
+									}
+									else PUGI_IMPL_THROW_ERROR(status_bad_start_element, s);
+								}
+								else if (*s == '>')
+								{
+									++s;
+
+									break;
+								}
+								else if (*s == 0 && endch == '>')
+								{
+									break;
+								}
+								else PUGI_IMPL_THROW_ERROR(status_bad_start_element, s);
+							}
+
+							// !!!
+						}
+						else if (ch == '/') // '<#.../'
+						{
+							if (!PUGI_IMPL_ENDSWITH(*s, '>')) PUGI_IMPL_THROW_ERROR(status_bad_start_element, s);
+
+							PUGI_IMPL_POPNODE(); // Pop.
+
+							s += (*s == '>');
+						}
+						else if (ch == 0)
+						{
+							// we stepped over null terminator, backtrack & handle closing tag
+							--s;
+
+							if (endch != '>') PUGI_IMPL_THROW_ERROR(status_bad_start_element, s);
+						}
+						else PUGI_IMPL_THROW_ERROR(status_bad_start_element, s);
+					}
+					else if (*s == '/')
+					{
+						++s;
+
+						mark = s;
+
+						char_t* name = cursor->name;
+						if (!name) PUGI_IMPL_THROW_ERROR(status_end_element_mismatch, mark);
+
+						while (PUGI_IMPL_IS_CHARTYPE(*s, ct_symbol))
+						{
+							if (*s++ != *name++) PUGI_IMPL_THROW_ERROR(status_end_element_mismatch, mark);
+						}
+
+						if (*name)
+						{
+							if (*s == 0 && name[0] == endch && name[1] == 0) PUGI_IMPL_THROW_ERROR(status_bad_end_element, s);
+							else PUGI_IMPL_THROW_ERROR(status_end_element_mismatch, mark);
+						}
+
+						PUGI_IMPL_POPNODE(); // Pop.
+
+						PUGI_IMPL_SKIPWS();
+
+						if (*s == 0)
+						{
+							if (endch != '>') PUGI_IMPL_THROW_ERROR(status_bad_end_element, s);
+						}
+						else
+						{
+							if (*s != '>') PUGI_IMPL_THROW_ERROR(status_bad_end_element, s);
+							++s;
+						}
+					}
+					else if (*s == '?') // '<?...'
+					{
+						s = parse_question(s, cursor, optmsk, endch);
+						if (!s) return s;
+
+						assert(cursor);
+						if (PUGI_IMPL_NODETYPE(cursor) == node_declaration) goto LOC_ATTRIBUTES;
+					}
+					else if (*s == '!') // '<!...'
+					{
+						s = parse_exclamation(s, cursor, optmsk, endch);
+						if (!s) return s;
+					}
+					else if (*s == 0 && endch == '?') PUGI_IMPL_THROW_ERROR(status_bad_pi, s);
+					else PUGI_IMPL_THROW_ERROR(status_unrecognized_tag, s);
+				}
+				else
+				{
+					mark = s; // Save this offset while searching for a terminator.
+
+					PUGI_IMPL_SKIPWS(); // Eat whitespace if no genuine PCDATA here.
+
+					if (*s == '<' || !*s)
+					{
+						// We skipped some whitespace characters because otherwise we would take the tag branch instead of PCDATA one
+						assert(mark != s);
+
+						if (!PUGI_IMPL_OPTSET(parse_ws_pcdata | parse_ws_pcdata_single) || PUGI_IMPL_OPTSET(parse_trim_pcdata))
+						{
+							continue;
+						}
+						else if (PUGI_IMPL_OPTSET(parse_ws_pcdata_single))
+						{
+							if (s[0] != '<' || s[1] != '/' || cursor->first_child) continue;
+						}
+					}
+
+					if (!PUGI_IMPL_OPTSET(parse_trim_pcdata))
+						s = mark;
+
+					if (cursor->parent || PUGI_IMPL_OPTSET(parse_fragment))
+					{
+						char_t* parsed_pcdata = s;
+
+						s = strconv_pcdata(s);
+
+						if (PUGI_IMPL_OPTSET(parse_embed_pcdata) && cursor->parent && !cursor->first_child && !cursor->value)
+						{
+							cursor->value = parsed_pcdata; // Save the offset.
+						}
+						else if (PUGI_IMPL_OPTSET(parse_merge_pcdata) && cursor->first_child && PUGI_IMPL_NODETYPE(cursor->first_child->prev_sibling_c) == node_pcdata)
+						{
+							assert(merged_pcdata >= cursor->first_child->prev_sibling_c->value);
+
+							// Catch up to the end of last parsed value; only needed for the first fragment.
+							merged_pcdata += strlength(merged_pcdata);
+
+							size_t length = strlength(parsed_pcdata);
+
+							// Must use memmove instead of memcpy as this move may overlap
+							memmove(merged_pcdata, parsed_pcdata, (length + 1) * sizeof(char_t));
+							merged_pcdata += length;
+						}
+						else
+						{
+							xml_node_struct* prev_cursor = cursor;
+							PUGI_IMPL_PUSHNODE(node_pcdata); // Append a new node on the tree.
+
+							cursor->value = parsed_pcdata; // Save the offset.
+							merged_pcdata = parsed_pcdata; // Used for parse_merge_pcdata above, cheaper to save unconditionally
+
+							cursor = prev_cursor; // Pop since this is a standalone.
+						}
+
+						if (!*s) break;
+					}
+					else
+					{
+						PUGI_IMPL_SCANFOR(*s == '<'); // '...<'
+						if (!*s) break;
+
+						++s;
+					}
+
+					// We're after '<'
+					goto LOC_TAG;
+				}
+			}
+
+			// check that last tag is closed
+			if (cursor != root) PUGI_IMPL_THROW_ERROR(status_end_element_mismatch, s);
+
+			return s;
+		}
+
+	#ifdef PUGIXML_WCHAR_MODE
+		static char_t* parse_skip_bom(char_t* s)
+		{
+			unsigned int bom = 0xfeff;
+			return (s[0] == static_cast<wchar_t>(bom)) ? s + 1 : s;
+		}
+	#else
+		static char_t* parse_skip_bom(char_t* s)
+		{
+			return (s[0] == '\xef' && s[1] == '\xbb' && s[2] == '\xbf') ? s + 3 : s;
+		}
+	#endif
+
+		static bool has_element_node_siblings(xml_node_struct* node)
+		{
+			while (node)
+			{
+				if (PUGI_IMPL_NODETYPE(node) == node_element) return true;
+
+				node = node->next_sibling;
+			}
+
+			return false;
+		}
+
+		static xml_parse_result parse(char_t* buffer, size_t length, xml_document_struct* xmldoc, xml_node_struct* root, unsigned int optmsk)
+		{
+			// early-out for empty documents
+			if (length == 0)
+				return make_parse_result(PUGI_IMPL_OPTSET(parse_fragment) ? status_ok : status_no_document_element);
+
+			// get last child of the root before parsing
+			xml_node_struct* last_root_child = root->first_child ? root->first_child->prev_sibling_c + 0 : 0;
+
+			// create parser on stack
+			xml_parser parser(static_cast<xml_allocator*>(xmldoc));
+
+			// save last character and make buffer zero-terminated (speeds up parsing)
+			char_t endch = buffer[length - 1];
+			buffer[length - 1] = 0;
+
+			// skip BOM to make sure it does not end up as part of parse output
+			char_t* buffer_data = parse_skip_bom(buffer);
+
+			// perform actual parsing
+			parser.parse_tree(buffer_data, root, optmsk, endch);
+
+			xml_parse_result result = make_parse_result(parser.error_status, parser.error_offset ? parser.error_offset - buffer : 0);
+			assert(result.offset >= 0 && static_cast<size_t>(result.offset) <= length);
+
+			if (result)
+			{
+				// since we removed last character, we have to handle the only possible false positive (stray <)
+				if (endch == '<')
+					return make_parse_result(status_unrecognized_tag, length - 1);
+
+				// check if there are any element nodes parsed
+				xml_node_struct* first_root_child_parsed = last_root_child ? last_root_child->next_sibling + 0 : root->first_child + 0;
+
+				if (!PUGI_IMPL_OPTSET(parse_fragment) && !has_element_node_siblings(first_root_child_parsed))
+					return make_parse_result(status_no_document_element, length - 1);
+			}
+			else
+			{
+				// roll back offset if it occurs on a null terminator in the source buffer
+				if (result.offset > 0 && static_cast<size_t>(result.offset) == length - 1 && endch == 0)
+					result.offset--;
+			}
+
+			return result;
+		}
+	};
+
+	// Output facilities
+	PUGI_IMPL_FN xml_encoding get_write_native_encoding()
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		return get_wchar_encoding();
+	#else
+		return encoding_utf8;
+	#endif
+	}
+
+	PUGI_IMPL_FN xml_encoding get_write_encoding(xml_encoding encoding)
+	{
+		// replace wchar encoding with utf implementation
+		if (encoding == encoding_wchar) return get_wchar_encoding();
+
+		// replace utf16 encoding with utf16 with specific endianness
+		if (encoding == encoding_utf16) return is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+		// replace utf32 encoding with utf32 with specific endianness
+		if (encoding == encoding_utf32) return is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+		// only do autodetection if no explicit encoding is requested
+		if (encoding != encoding_auto) return encoding;
+
+		// assume utf8 encoding
+		return encoding_utf8;
+	}
+
+	template <typename D, typename T> PUGI_IMPL_FN size_t convert_buffer_output_generic(typename T::value_type dest, const char_t* data, size_t length, D, T)
+	{
+		PUGI_IMPL_STATIC_ASSERT(sizeof(char_t) == sizeof(typename D::type));
+
+		typename T::value_type end = D::process(reinterpret_cast<const typename D::type*>(data), length, dest, T());
+
+		return static_cast<size_t>(end - dest) * sizeof(*dest);
+	}
+
+	template <typename D, typename T> PUGI_IMPL_FN size_t convert_buffer_output_generic(typename T::value_type dest, const char_t* data, size_t length, D, T, bool opt_swap)
+	{
+		PUGI_IMPL_STATIC_ASSERT(sizeof(char_t) == sizeof(typename D::type));
+
+		typename T::value_type end = D::process(reinterpret_cast<const typename D::type*>(data), length, dest, T());
+
+		if (opt_swap)
+		{
+			for (typename T::value_type i = dest; i != end; ++i)
+				*i = endian_swap(*i);
+		}
+
+		return static_cast<size_t>(end - dest) * sizeof(*dest);
+	}
+
+#ifdef PUGIXML_WCHAR_MODE
+	PUGI_IMPL_FN size_t get_valid_length(const char_t* data, size_t length)
+	{
+		if (length < 1) return 0;
+
+		// discard last character if it's the lead of a surrogate pair
+		return (sizeof(wchar_t) == 2 && static_cast<unsigned int>(static_cast<uint16_t>(data[length - 1]) - 0xD800) < 0x400) ? length - 1 : length;
+	}
+
+	PUGI_IMPL_FN size_t convert_buffer_output(char_t* r_char, uint8_t* r_u8, uint16_t* r_u16, uint32_t* r_u32, const char_t* data, size_t length, xml_encoding encoding)
+	{
+		// only endian-swapping is required
+		if (need_endian_swap_utf(encoding, get_wchar_encoding()))
+		{
+			convert_wchar_endian_swap(r_char, data, length);
+
+			return length * sizeof(char_t);
+		}
+
+		// convert to utf8
+		if (encoding == encoding_utf8)
+			return convert_buffer_output_generic(r_u8, data, length, wchar_decoder(), utf8_writer());
+
+		// convert to utf16
+		if (encoding == encoding_utf16_be || encoding == encoding_utf16_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+			return convert_buffer_output_generic(r_u16, data, length, wchar_decoder(), utf16_writer(), native_encoding != encoding);
+		}
+
+		// convert to utf32
+		if (encoding == encoding_utf32_be || encoding == encoding_utf32_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+			return convert_buffer_output_generic(r_u32, data, length, wchar_decoder(), utf32_writer(), native_encoding != encoding);
+		}
+
+		// convert to latin1
+		if (encoding == encoding_latin1)
+			return convert_buffer_output_generic(r_u8, data, length, wchar_decoder(), latin1_writer());
+
+		assert(false && "Invalid encoding"); // unreachable
+		return 0;
+	}
+#else
+	PUGI_IMPL_FN size_t get_valid_length(const char_t* data, size_t length)
+	{
+		if (length < 5) return 0;
+
+		for (size_t i = 1; i <= 4; ++i)
+		{
+			uint8_t ch = static_cast<uint8_t>(data[length - i]);
+
+			// either a standalone character or a leading one
+			if ((ch & 0xc0) != 0x80) return length - i;
+		}
+
+		// there are four non-leading characters at the end, sequence tail is broken so might as well process the whole chunk
+		return length;
+	}
+
+	PUGI_IMPL_FN size_t convert_buffer_output(char_t* /* r_char */, uint8_t* r_u8, uint16_t* r_u16, uint32_t* r_u32, const char_t* data, size_t length, xml_encoding encoding)
+	{
+		if (encoding == encoding_utf16_be || encoding == encoding_utf16_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf16_le : encoding_utf16_be;
+
+			return convert_buffer_output_generic(r_u16, data, length, utf8_decoder(), utf16_writer(), native_encoding != encoding);
+		}
+
+		if (encoding == encoding_utf32_be || encoding == encoding_utf32_le)
+		{
+			xml_encoding native_encoding = is_little_endian() ? encoding_utf32_le : encoding_utf32_be;
+
+			return convert_buffer_output_generic(r_u32, data, length, utf8_decoder(), utf32_writer(), native_encoding != encoding);
+		}
+
+		if (encoding == encoding_latin1)
+			return convert_buffer_output_generic(r_u8, data, length, utf8_decoder(), latin1_writer());
+
+		assert(false && "Invalid encoding"); // unreachable
+		return 0;
+	}
+#endif
+
+	class xml_buffered_writer
+	{
+		xml_buffered_writer(const xml_buffered_writer&);
+		xml_buffered_writer& operator=(const xml_buffered_writer&);
+
+	public:
+		xml_buffered_writer(xml_writer& writer_, xml_encoding user_encoding): writer(writer_), bufsize(0), encoding(get_write_encoding(user_encoding))
+		{
+			PUGI_IMPL_STATIC_ASSERT(bufcapacity >= 8);
+		}
+
+		size_t flush()
+		{
+			flush(buffer, bufsize);
+			bufsize = 0;
+			return 0;
+		}
+
+		void flush(const char_t* data, size_t size)
+		{
+			if (size == 0) return;
+
+			// fast path, just write data
+			if (encoding == get_write_native_encoding())
+				writer.write(data, size * sizeof(char_t));
+			else
+			{
+				// convert chunk
+				size_t result = convert_buffer_output(scratch.data_char, scratch.data_u8, scratch.data_u16, scratch.data_u32, data, size, encoding);
+				assert(result <= sizeof(scratch));
+
+				// write data
+				writer.write(scratch.data_u8, result);
+			}
+		}
+
+		void write_direct(const char_t* data, size_t length)
+		{
+			// flush the remaining buffer contents
+			flush();
+
+			// handle large chunks
+			if (length > bufcapacity)
+			{
+				if (encoding == get_write_native_encoding())
+				{
+					// fast path, can just write data chunk
+					writer.write(data, length * sizeof(char_t));
+					return;
+				}
+
+				// need to convert in suitable chunks
+				while (length > bufcapacity)
+				{
+					// get chunk size by selecting such number of characters that are guaranteed to fit into scratch buffer
+					// and form a complete codepoint sequence (i.e. discard start of last codepoint if necessary)
+					size_t chunk_size = get_valid_length(data, bufcapacity);
+					assert(chunk_size);
+
+					// convert chunk and write
+					flush(data, chunk_size);
+
+					// iterate
+					data += chunk_size;
+					length -= chunk_size;
+				}
+
+				// small tail is copied below
+				bufsize = 0;
+			}
+
+			memcpy(buffer + bufsize, data, length * sizeof(char_t));
+			bufsize += length;
+		}
+
+		void write_buffer(const char_t* data, size_t length)
+		{
+			size_t offset = bufsize;
+
+			if (offset + length <= bufcapacity)
+			{
+				memcpy(buffer + offset, data, length * sizeof(char_t));
+				bufsize = offset + length;
+			}
+			else
+			{
+				write_direct(data, length);
+			}
+		}
+
+		void write_string(const char_t* data)
+		{
+			// write the part of the string that fits in the buffer
+			size_t offset = bufsize;
+
+			while (*data && offset < bufcapacity)
+				buffer[offset++] = *data++;
+
+			// write the rest
+			if (offset < bufcapacity)
+			{
+				bufsize = offset;
+			}
+			else
+			{
+				// backtrack a bit if we have split the codepoint
+				size_t length = offset - bufsize;
+				size_t extra = length - get_valid_length(data - length, length);
+
+				bufsize = offset - extra;
+
+				write_direct(data - extra, strlength(data) + extra);
+			}
+		}
+
+		void write(char_t d0)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 1) offset = flush();
+
+			buffer[offset + 0] = d0;
+			bufsize = offset + 1;
+		}
+
+		void write(char_t d0, char_t d1)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 2) offset = flush();
+
+			buffer[offset + 0] = d0;
+			buffer[offset + 1] = d1;
+			bufsize = offset + 2;
+		}
+
+		void write(char_t d0, char_t d1, char_t d2)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 3) offset = flush();
+
+			buffer[offset + 0] = d0;
+			buffer[offset + 1] = d1;
+			buffer[offset + 2] = d2;
+			bufsize = offset + 3;
+		}
+
+		void write(char_t d0, char_t d1, char_t d2, char_t d3)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 4) offset = flush();
+
+			buffer[offset + 0] = d0;
+			buffer[offset + 1] = d1;
+			buffer[offset + 2] = d2;
+			buffer[offset + 3] = d3;
+			bufsize = offset + 4;
+		}
+
+		void write(char_t d0, char_t d1, char_t d2, char_t d3, char_t d4)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 5) offset = flush();
+
+			buffer[offset + 0] = d0;
+			buffer[offset + 1] = d1;
+			buffer[offset + 2] = d2;
+			buffer[offset + 3] = d3;
+			buffer[offset + 4] = d4;
+			bufsize = offset + 5;
+		}
+
+		void write(char_t d0, char_t d1, char_t d2, char_t d3, char_t d4, char_t d5)
+		{
+			size_t offset = bufsize;
+			if (offset > bufcapacity - 6) offset = flush();
+
+			buffer[offset + 0] = d0;
+			buffer[offset + 1] = d1;
+			buffer[offset + 2] = d2;
+			buffer[offset + 3] = d3;
+			buffer[offset + 4] = d4;
+			buffer[offset + 5] = d5;
+			bufsize = offset + 6;
+		}
+
+		// utf8 maximum expansion: x4 (-> utf32)
+		// utf16 maximum expansion: x2 (-> utf32)
+		// utf32 maximum expansion: x1
+		enum
+		{
+			bufcapacitybytes =
+			#ifdef PUGIXML_MEMORY_OUTPUT_STACK
+				PUGIXML_MEMORY_OUTPUT_STACK
+			#else
+				10240
+			#endif
+			,
+			bufcapacity = bufcapacitybytes / (sizeof(char_t) + 4)
+		};
+
+		char_t buffer[bufcapacity];
+
+		union
+		{
+			uint8_t data_u8[4 * bufcapacity];
+			uint16_t data_u16[2 * bufcapacity];
+			uint32_t data_u32[bufcapacity];
+			char_t data_char[bufcapacity];
+		} scratch;
+
+		xml_writer& writer;
+		size_t bufsize;
+		xml_encoding encoding;
+	};
+
+	PUGI_IMPL_FN void text_output_escaped(xml_buffered_writer& writer, const char_t* s, chartypex_t type, unsigned int flags)
+	{
+		while (*s)
+		{
+			const char_t* prev = s;
+
+			// While *s is a usual symbol
+			PUGI_IMPL_SCANWHILE_UNROLL(!PUGI_IMPL_IS_CHARTYPEX(ss, type));
+
+			writer.write_buffer(prev, static_cast<size_t>(s - prev));
+
+			switch (*s)
+			{
+				case 0: break;
+				case '&':
+					writer.write('&', 'a', 'm', 'p', ';');
+					++s;
+					break;
+				case '<':
+					writer.write('&', 'l', 't', ';');
+					++s;
+					break;
+				case '>':
+					writer.write('&', 'g', 't', ';');
+					++s;
+					break;
+				case '"':
+					if (flags & format_attribute_single_quote)
+						writer.write('"');
+					else
+						writer.write('&', 'q', 'u', 'o', 't', ';');
+					++s;
+					break;
+				case '\'':
+					if (flags & format_attribute_single_quote)
+						writer.write('&', 'a', 'p', 'o', 's', ';');
+					else
+						writer.write('\'');
+					++s;
+					break;
+				default: // s is not a usual symbol
+				{
+					unsigned int ch = static_cast<unsigned int>(*s++);
+					assert(ch < 32);
+
+					if (!(flags & format_skip_control_chars))
+						writer.write('&', '#', static_cast<char_t>((ch / 10) + '0'), static_cast<char_t>((ch % 10) + '0'), ';');
+				}
+			}
+		}
+	}
+
+	PUGI_IMPL_FN void text_output(xml_buffered_writer& writer, const char_t* s, chartypex_t type, unsigned int flags)
+	{
+		if (flags & format_no_escapes)
+			writer.write_string(s);
+		else
+			text_output_escaped(writer, s, type, flags);
+	}
+
+	PUGI_IMPL_FN void text_output_cdata(xml_buffered_writer& writer, const char_t* s)
+	{
+		do
+		{
+			writer.write('<', '!', '[', 'C', 'D');
+			writer.write('A', 'T', 'A', '[');
+
+			const char_t* prev = s;
+
+			// look for ]]> sequence - we can't output it as is since it terminates CDATA
+			while (*s && !(s[0] == ']' && s[1] == ']' && s[2] == '>')) ++s;
+
+			// skip ]] if we stopped at ]]>, > will go to the next CDATA section
+			if (*s) s += 2;
+
+			writer.write_buffer(prev, static_cast<size_t>(s - prev));
+
+			writer.write(']', ']', '>');
+		}
+		while (*s);
+	}
+
+	PUGI_IMPL_FN void text_output_indent(xml_buffered_writer& writer, const char_t* indent, size_t indent_length, unsigned int depth)
+	{
+		switch (indent_length)
+		{
+		case 1:
+		{
+			for (unsigned int i = 0; i < depth; ++i)
+				writer.write(indent[0]);
+			break;
+		}
+
+		case 2:
+		{
+			for (unsigned int i = 0; i < depth; ++i)
+				writer.write(indent[0], indent[1]);
+			break;
+		}
+
+		case 3:
+		{
+			for (unsigned int i = 0; i < depth; ++i)
+				writer.write(indent[0], indent[1], indent[2]);
+			break;
+		}
+
+		case 4:
+		{
+			for (unsigned int i = 0; i < depth; ++i)
+				writer.write(indent[0], indent[1], indent[2], indent[3]);
+			break;
+		}
+
+		default:
+		{
+			for (unsigned int i = 0; i < depth; ++i)
+				writer.write_buffer(indent, indent_length);
+		}
+		}
+	}
+
+	PUGI_IMPL_FN void node_output_comment(xml_buffered_writer& writer, const char_t* s)
+	{
+		writer.write('<', '!', '-', '-');
+
+		while (*s)
+		{
+			const char_t* prev = s;
+
+			// look for -\0 or -- sequence - we can't output it since -- is illegal in comment body
+			while (*s && !(s[0] == '-' && (s[1] == '-' || s[1] == 0))) ++s;
+
+			writer.write_buffer(prev, static_cast<size_t>(s - prev));
+
+			if (*s)
+			{
+				assert(*s == '-');
+
+				writer.write('-', ' ');
+				++s;
+			}
+		}
+
+		writer.write('-', '-', '>');
+	}
+
+	PUGI_IMPL_FN void node_output_pi_value(xml_buffered_writer& writer, const char_t* s)
+	{
+		while (*s)
+		{
+			const char_t* prev = s;
+
+			// look for ?> sequence - we can't output it since ?> terminates PI
+			while (*s && !(s[0] == '?' && s[1] == '>')) ++s;
+
+			writer.write_buffer(prev, static_cast<size_t>(s - prev));
+
+			if (*s)
+			{
+				assert(s[0] == '?' && s[1] == '>');
+
+				writer.write('?', ' ', '>');
+				s += 2;
+			}
+		}
+	}
+
+	PUGI_IMPL_FN void node_output_attributes(xml_buffered_writer& writer, xml_node_struct* node, const char_t* indent, size_t indent_length, unsigned int flags, unsigned int depth)
+	{
+		const char_t* default_name = PUGIXML_TEXT(":anonymous");
+		const char_t enquotation_char = (flags & format_attribute_single_quote) ? '\'' : '"';
+
+		for (xml_attribute_struct* a = node->first_attribute; a; a = a->next_attribute)
+		{
+			if ((flags & (format_indent_attributes | format_raw)) == format_indent_attributes)
+			{
+				writer.write('\n');
+
+				text_output_indent(writer, indent, indent_length, depth + 1);
+			}
+			else
+			{
+				writer.write(' ');
+			}
+
+			writer.write_string(a->name ? a->name + 0 : default_name);
+			writer.write('=', enquotation_char);
+
+			if (a->value)
+				text_output(writer, a->value, ctx_special_attr, flags);
+
+			writer.write(enquotation_char);
+		}
+	}
+
+	PUGI_IMPL_FN bool node_output_start(xml_buffered_writer& writer, xml_node_struct* node, const char_t* indent, size_t indent_length, unsigned int flags, unsigned int depth)
+	{
+		const char_t* default_name = PUGIXML_TEXT(":anonymous");
+		const char_t* name = node->name ? node->name + 0 : default_name;
+
+		writer.write('<');
+		writer.write_string(name);
+
+		if (node->first_attribute)
+			node_output_attributes(writer, node, indent, indent_length, flags, depth);
+
+		// element nodes can have value if parse_embed_pcdata was used
+		if (!node->value)
+		{
+			if (!node->first_child)
+			{
+				if (flags & format_no_empty_element_tags)
+				{
+					writer.write('>', '<', '/');
+					writer.write_string(name);
+					writer.write('>');
+
+					return false;
+				}
+				else
+				{
+					if ((flags & format_raw) == 0)
+						writer.write(' ');
+
+					writer.write('/', '>');
+
+					return false;
+				}
+			}
+			else
+			{
+				writer.write('>');
+
+				return true;
+			}
+		}
+		else
+		{
+			writer.write('>');
+
+			text_output(writer, node->value, ctx_special_pcdata, flags);
+
+			if (!node->first_child)
+			{
+				writer.write('<', '/');
+				writer.write_string(name);
+				writer.write('>');
+
+				return false;
+			}
+			else
+			{
+				return true;
+			}
+		}
+	}
+
+	PUGI_IMPL_FN void node_output_end(xml_buffered_writer& writer, xml_node_struct* node)
+	{
+		const char_t* default_name = PUGIXML_TEXT(":anonymous");
+		const char_t* name = node->name ? node->name + 0 : default_name;
+
+		writer.write('<', '/');
+		writer.write_string(name);
+		writer.write('>');
+	}
+
+	PUGI_IMPL_FN void node_output_simple(xml_buffered_writer& writer, xml_node_struct* node, unsigned int flags)
+	{
+		const char_t* default_name = PUGIXML_TEXT(":anonymous");
+
+		switch (PUGI_IMPL_NODETYPE(node))
+		{
+			case node_pcdata:
+				text_output(writer, node->value ? node->value + 0 : PUGIXML_TEXT(""), ctx_special_pcdata, flags);
+				break;
+
+			case node_cdata:
+				text_output_cdata(writer, node->value ? node->value + 0 : PUGIXML_TEXT(""));
+				break;
+
+			case node_comment:
+				node_output_comment(writer, node->value ? node->value + 0 : PUGIXML_TEXT(""));
+				break;
+
+			case node_pi:
+				writer.write('<', '?');
+				writer.write_string(node->name ? node->name + 0 : default_name);
+
+				if (node->value)
+				{
+					writer.write(' ');
+					node_output_pi_value(writer, node->value);
+				}
+
+				writer.write('?', '>');
+				break;
+
+			case node_declaration:
+				writer.write('<', '?');
+				writer.write_string(node->name ? node->name + 0 : default_name);
+				node_output_attributes(writer, node, PUGIXML_TEXT(""), 0, flags | format_raw, 0);
+				writer.write('?', '>');
+				break;
+
+			case node_doctype:
+				writer.write('<', '!', 'D', 'O', 'C');
+				writer.write('T', 'Y', 'P', 'E');
+
+				if (node->value)
+				{
+					writer.write(' ');
+					writer.write_string(node->value);
+				}
+
+				writer.write('>');
+				break;
+
+			default:
+				assert(false && "Invalid node type"); // unreachable
+		}
+	}
+
+	enum indent_flags_t
+	{
+		indent_newline = 1,
+		indent_indent = 2
+	};
+
+	PUGI_IMPL_FN void node_output(xml_buffered_writer& writer, xml_node_struct* root, const char_t* indent, unsigned int flags, unsigned int depth)
+	{
+		size_t indent_length = ((flags & (format_indent | format_indent_attributes)) && (flags & format_raw) == 0) ? strlength(indent) : 0;
+		unsigned int indent_flags = indent_indent;
+
+		xml_node_struct* node = root;
+
+		do
+		{
+			assert(node);
+
+			// begin writing current node
+			if (PUGI_IMPL_NODETYPE(node) == node_pcdata || PUGI_IMPL_NODETYPE(node) == node_cdata)
+			{
+				node_output_simple(writer, node, flags);
+
+				indent_flags = 0;
+			}
+			else
+			{
+				if ((indent_flags & indent_newline) && (flags & format_raw) == 0)
+					writer.write('\n');
+
+				if ((indent_flags & indent_indent) && indent_length)
+					text_output_indent(writer, indent, indent_length, depth);
+
+				if (PUGI_IMPL_NODETYPE(node) == node_element)
+				{
+					indent_flags = indent_newline | indent_indent;
+
+					if (node_output_start(writer, node, indent, indent_length, flags, depth))
+					{
+						// element nodes can have value if parse_embed_pcdata was used
+						if (node->value)
+							indent_flags = 0;
+
+						node = node->first_child;
+						depth++;
+						continue;
+					}
+				}
+				else if (PUGI_IMPL_NODETYPE(node) == node_document)
+				{
+					indent_flags = indent_indent;
+
+					if (node->first_child)
+					{
+						node = node->first_child;
+						continue;
+					}
+				}
+				else
+				{
+					node_output_simple(writer, node, flags);
+
+					indent_flags = indent_newline | indent_indent;
+				}
+			}
+
+			// continue to the next node
+			while (node != root)
+			{
+				if (node->next_sibling)
+				{
+					node = node->next_sibling;
+					break;
+				}
+
+				node = node->parent;
+
+				// write closing node
+				if (PUGI_IMPL_NODETYPE(node) == node_element)
+				{
+					depth--;
+
+					if ((indent_flags & indent_newline) && (flags & format_raw) == 0)
+						writer.write('\n');
+
+					if ((indent_flags & indent_indent) && indent_length)
+						text_output_indent(writer, indent, indent_length, depth);
+
+					node_output_end(writer, node);
+
+					indent_flags = indent_newline | indent_indent;
+				}
+			}
+		}
+		while (node != root);
+
+		if ((indent_flags & indent_newline) && (flags & format_raw) == 0)
+			writer.write('\n');
+	}
+
+	PUGI_IMPL_FN bool has_declaration(xml_node_struct* node)
+	{
+		for (xml_node_struct* child = node->first_child; child; child = child->next_sibling)
+		{
+			xml_node_type type = PUGI_IMPL_NODETYPE(child);
+
+			if (type == node_declaration) return true;
+			if (type == node_element) return false;
+		}
+
+		return false;
+	}
+
+	PUGI_IMPL_FN bool is_attribute_of(xml_attribute_struct* attr, xml_node_struct* node)
+	{
+		for (xml_attribute_struct* a = node->first_attribute; a; a = a->next_attribute)
+			if (a == attr)
+				return true;
+
+		return false;
+	}
+
+	PUGI_IMPL_FN bool allow_insert_attribute(xml_node_type parent)
+	{
+		return parent == node_element || parent == node_declaration;
+	}
+
+	PUGI_IMPL_FN bool allow_insert_child(xml_node_type parent, xml_node_type child)
+	{
+		if (parent != node_document && parent != node_element) return false;
+		if (child == node_document || child == node_null) return false;
+		if (parent != node_document && (child == node_declaration || child == node_doctype)) return false;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool allow_move(xml_node parent, xml_node child)
+	{
+		// check that child can be a child of parent
+		if (!allow_insert_child(parent.type(), child.type()))
+			return false;
+
+		// check that node is not moved between documents
+		if (parent.root() != child.root())
+			return false;
+
+		// check that new parent is not in the child subtree
+		xml_node cur = parent;
+
+		while (cur)
+		{
+			if (cur == child)
+				return false;
+
+			cur = cur.parent();
+		}
+
+		return true;
+	}
+
+	template <typename String, typename Header>
+	PUGI_IMPL_FN void node_copy_string(String& dest, Header& header, uintptr_t header_mask, char_t* source, Header& source_header, xml_allocator* alloc)
+	{
+		assert(!dest && (header & header_mask) == 0); // copies are performed into fresh nodes
+
+		if (source)
+		{
+			if (alloc && (source_header & header_mask) == 0)
+			{
+				dest = source;
+
+				// since strcpy_insitu can reuse document buffer memory we need to mark both source and dest as shared
+				header |= xml_memory_page_contents_shared_mask;
+				source_header |= xml_memory_page_contents_shared_mask;
+			}
+			else
+				strcpy_insitu(dest, header, header_mask, source, strlength(source));
+		}
+	}
+
+	PUGI_IMPL_FN void node_copy_contents(xml_node_struct* dn, xml_node_struct* sn, xml_allocator* shared_alloc)
+	{
+		node_copy_string(dn->name, dn->header, xml_memory_page_name_allocated_mask, sn->name, sn->header, shared_alloc);
+		node_copy_string(dn->value, dn->header, xml_memory_page_value_allocated_mask, sn->value, sn->header, shared_alloc);
+
+		for (xml_attribute_struct* sa = sn->first_attribute; sa; sa = sa->next_attribute)
+		{
+			xml_attribute_struct* da = append_new_attribute(dn, get_allocator(dn));
+
+			if (da)
+			{
+				node_copy_string(da->name, da->header, xml_memory_page_name_allocated_mask, sa->name, sa->header, shared_alloc);
+				node_copy_string(da->value, da->header, xml_memory_page_value_allocated_mask, sa->value, sa->header, shared_alloc);
+			}
+		}
+	}
+
+	PUGI_IMPL_FN void node_copy_tree(xml_node_struct* dn, xml_node_struct* sn)
+	{
+		xml_allocator& alloc = get_allocator(dn);
+		xml_allocator* shared_alloc = (&alloc == &get_allocator(sn)) ? &alloc : 0;
+
+		node_copy_contents(dn, sn, shared_alloc);
+
+		xml_node_struct* dit = dn;
+		xml_node_struct* sit = sn->first_child;
+
+		while (sit && sit != sn)
+		{
+			// loop invariant: dit is inside the subtree rooted at dn
+			assert(dit);
+
+			// when a tree is copied into one of the descendants, we need to skip that subtree to avoid an infinite loop
+			if (sit != dn)
+			{
+				xml_node_struct* copy = append_new_node(dit, alloc, PUGI_IMPL_NODETYPE(sit));
+
+				if (copy)
+				{
+					node_copy_contents(copy, sit, shared_alloc);
+
+					if (sit->first_child)
+					{
+						dit = copy;
+						sit = sit->first_child;
+						continue;
+					}
+				}
+			}
+
+			// continue to the next node
+			do
+			{
+				if (sit->next_sibling)
+				{
+					sit = sit->next_sibling;
+					break;
+				}
+
+				sit = sit->parent;
+				dit = dit->parent;
+
+				// loop invariant: dit is inside the subtree rooted at dn while sit is inside sn
+				assert(sit == sn || dit);
+			}
+			while (sit != sn);
+		}
+
+		assert(!sit || dit == dn->parent);
+	}
+
+	PUGI_IMPL_FN void node_copy_attribute(xml_attribute_struct* da, xml_attribute_struct* sa)
+	{
+		xml_allocator& alloc = get_allocator(da);
+		xml_allocator* shared_alloc = (&alloc == &get_allocator(sa)) ? &alloc : 0;
+
+		node_copy_string(da->name, da->header, xml_memory_page_name_allocated_mask, sa->name, sa->header, shared_alloc);
+		node_copy_string(da->value, da->header, xml_memory_page_value_allocated_mask, sa->value, sa->header, shared_alloc);
+	}
+
+	inline bool is_text_node(xml_node_struct* node)
+	{
+		xml_node_type type = PUGI_IMPL_NODETYPE(node);
+
+		return type == node_pcdata || type == node_cdata;
+	}
+
+	// get value with conversion functions
+	template <typename U> PUGI_IMPL_FN PUGI_IMPL_UNSIGNED_OVERFLOW U string_to_integer(const char_t* value, U minv, U maxv)
+	{
+		U result = 0;
+		const char_t* s = value;
+
+		while (PUGI_IMPL_IS_CHARTYPE(*s, ct_space))
+			s++;
+
+		bool negative = (*s == '-');
+
+		s += (*s == '+' || *s == '-');
+
+		bool overflow = false;
+
+		if (s[0] == '0' && (s[1] | ' ') == 'x')
+		{
+			s += 2;
+
+			// since overflow detection relies on length of the sequence skip leading zeros
+			while (*s == '0')
+				s++;
+
+			const char_t* start = s;
+
+			for (;;)
+			{
+				if (static_cast<unsigned>(*s - '0') < 10)
+					result = result * 16 + (*s - '0');
+				else if (static_cast<unsigned>((*s | ' ') - 'a') < 6)
+					result = result * 16 + ((*s | ' ') - 'a' + 10);
+				else
+					break;
+
+				s++;
+			}
+
+			size_t digits = static_cast<size_t>(s - start);
+
+			overflow = digits > sizeof(U) * 2;
+		}
+		else
+		{
+			// since overflow detection relies on length of the sequence skip leading zeros
+			while (*s == '0')
+				s++;
+
+			const char_t* start = s;
+
+			for (;;)
+			{
+				if (static_cast<unsigned>(*s - '0') < 10)
+					result = result * 10 + (*s - '0');
+				else
+					break;
+
+				s++;
+			}
+
+			size_t digits = static_cast<size_t>(s - start);
+
+			PUGI_IMPL_STATIC_ASSERT(sizeof(U) == 8 || sizeof(U) == 4 || sizeof(U) == 2);
+
+			const size_t max_digits10 = sizeof(U) == 8 ? 20 : sizeof(U) == 4 ? 10 : 5;
+			const char_t max_lead = sizeof(U) == 8 ? '1' : sizeof(U) == 4 ? '4' : '6';
+			const size_t high_bit = sizeof(U) * 8 - 1;
+
+			overflow = digits >= max_digits10 && !(digits == max_digits10 && (*start < max_lead || (*start == max_lead && result >> high_bit)));
+		}
+
+		if (negative)
+		{
+			// Workaround for crayc++ CC-3059: Expected no overflow in routine.
+		#ifdef _CRAYC
+			return (overflow || result > ~minv + 1) ? minv : ~result + 1;
+		#else
+			return (overflow || result > 0 - minv) ? minv : 0 - result;
+		#endif
+		}
+		else
+			return (overflow || result > maxv) ? maxv : result;
+	}
+
+	PUGI_IMPL_FN int get_value_int(const char_t* value)
+	{
+		return string_to_integer<unsigned int>(value, static_cast<unsigned int>(INT_MIN), INT_MAX);
+	}
+
+	PUGI_IMPL_FN unsigned int get_value_uint(const char_t* value)
+	{
+		return string_to_integer<unsigned int>(value, 0, UINT_MAX);
+	}
+
+	PUGI_IMPL_FN double get_value_double(const char_t* value)
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcstod(value, 0);
+	#else
+		return strtod(value, 0);
+	#endif
+	}
+
+	PUGI_IMPL_FN float get_value_float(const char_t* value)
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		return static_cast<float>(wcstod(value, 0));
+	#else
+		return static_cast<float>(strtod(value, 0));
+	#endif
+	}
+
+	PUGI_IMPL_FN bool get_value_bool(const char_t* value)
+	{
+		// only look at first char
+		char_t first = *value;
+
+		// 1*, t* (true), T* (True), y* (yes), Y* (YES)
+		return (first == '1' || first == 't' || first == 'T' || first == 'y' || first == 'Y');
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN long long get_value_llong(const char_t* value)
+	{
+		return string_to_integer<unsigned long long>(value, static_cast<unsigned long long>(LLONG_MIN), LLONG_MAX);
+	}
+
+	PUGI_IMPL_FN unsigned long long get_value_ullong(const char_t* value)
+	{
+		return string_to_integer<unsigned long long>(value, 0, ULLONG_MAX);
+	}
+#endif
+
+	template <typename U> PUGI_IMPL_FN PUGI_IMPL_UNSIGNED_OVERFLOW char_t* integer_to_string(char_t* begin, char_t* end, U value, bool negative)
+	{
+		char_t* result = end - 1;
+		U rest = negative ? 0 - value : value;
+
+		do
+		{
+			*result-- = static_cast<char_t>('0' + (rest % 10));
+			rest /= 10;
+		}
+		while (rest);
+
+		assert(result >= begin);
+		(void)begin;
+
+		*result = '-';
+
+		return result + !negative;
+	}
+
+	// set value with conversion functions
+	template <typename String, typename Header>
+	PUGI_IMPL_FN bool set_value_ascii(String& dest, Header& header, uintptr_t header_mask, char* buf)
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		char_t wbuf[128];
+		assert(strlen(buf) < sizeof(wbuf) / sizeof(wbuf[0]));
+
+		size_t offset = 0;
+		for (; buf[offset]; ++offset) wbuf[offset] = buf[offset];
+
+		return strcpy_insitu(dest, header, header_mask, wbuf, offset);
+	#else
+		return strcpy_insitu(dest, header, header_mask, buf, strlen(buf));
+	#endif
+	}
+
+	template <typename U, typename String, typename Header>
+	PUGI_IMPL_FN bool set_value_integer(String& dest, Header& header, uintptr_t header_mask, U value, bool negative)
+	{
+		char_t buf[64];
+		char_t* end = buf + sizeof(buf) / sizeof(buf[0]);
+		char_t* begin = integer_to_string(buf, end, value, negative);
+
+		return strcpy_insitu(dest, header, header_mask, begin, end - begin);
+	}
+
+	template <typename String, typename Header>
+	PUGI_IMPL_FN bool set_value_convert(String& dest, Header& header, uintptr_t header_mask, float value, int precision)
+	{
+		char buf[128];
+		PUGI_IMPL_SNPRINTF(buf, "%.*g", precision, double(value));
+
+		return set_value_ascii(dest, header, header_mask, buf);
+	}
+
+	template <typename String, typename Header>
+	PUGI_IMPL_FN bool set_value_convert(String& dest, Header& header, uintptr_t header_mask, double value, int precision)
+	{
+		char buf[128];
+		PUGI_IMPL_SNPRINTF(buf, "%.*g", precision, value);
+
+		return set_value_ascii(dest, header, header_mask, buf);
+	}
+
+	template <typename String, typename Header>
+	PUGI_IMPL_FN bool set_value_bool(String& dest, Header& header, uintptr_t header_mask, bool value)
+	{
+		return strcpy_insitu(dest, header, header_mask, value ? PUGIXML_TEXT("true") : PUGIXML_TEXT("false"), value ? 4 : 5);
+	}
+
+	PUGI_IMPL_FN xml_parse_result load_buffer_impl(xml_document_struct* doc, xml_node_struct* root, void* contents, size_t size, unsigned int options, xml_encoding encoding, bool is_mutable, bool own, char_t** out_buffer)
+	{
+		// check input buffer
+		if (!contents && size) return make_parse_result(status_io_error);
+
+		// get actual encoding
+		xml_encoding buffer_encoding = impl::get_buffer_encoding(encoding, contents, size);
+
+		// if convert_buffer below throws bad_alloc, we still need to deallocate contents if we own it
+		auto_deleter<void> contents_guard(own ? contents : 0, xml_memory::deallocate);
+
+		// get private buffer
+		char_t* buffer = 0;
+		size_t length = 0;
+
+		// coverity[var_deref_model]
+		if (!impl::convert_buffer(buffer, length, buffer_encoding, contents, size, is_mutable)) return impl::make_parse_result(status_out_of_memory);
+
+		// after this we either deallocate contents (below) or hold on to it via doc->buffer, so we don't need to guard it
+		contents_guard.release();
+
+		// delete original buffer if we performed a conversion
+		if (own && buffer != contents && contents) impl::xml_memory::deallocate(contents);
+
+		// grab onto buffer if it's our buffer, user is responsible for deallocating contents himself
+		if (own || buffer != contents) *out_buffer = buffer;
+
+		// store buffer for offset_debug
+		doc->buffer = buffer;
+
+		// parse
+		xml_parse_result res = impl::xml_parser::parse(buffer, length, doc, root, options);
+
+		// remember encoding
+		res.encoding = buffer_encoding;
+
+		return res;
+	}
+
+	// we need to get length of entire file to load it in memory; the only (relatively) sane way to do it is via seek/tell trick
+	PUGI_IMPL_FN xml_parse_status get_file_size(FILE* file, size_t& out_result)
+	{
+	#if defined(__linux__) || defined(__APPLE__)
+		// this simultaneously retrieves the file size and file mode (to guard against loading non-files)
+		struct stat st;
+		if (fstat(fileno(file), &st) != 0) return status_io_error;
+
+		// anything that's not a regular file doesn't have a coherent length
+		if (!S_ISREG(st.st_mode)) return status_io_error;
+
+		typedef off_t length_type;
+		length_type length = st.st_size;
+	#elif defined(PUGI_IMPL_MSVC_CRT_VERSION) && PUGI_IMPL_MSVC_CRT_VERSION >= 1400
+		// there are 64-bit versions of fseek/ftell, let's use them
+		typedef __int64 length_type;
+
+		_fseeki64(file, 0, SEEK_END);
+		length_type length = _ftelli64(file);
+		_fseeki64(file, 0, SEEK_SET);
+	#elif defined(__MINGW32__) && !defined(__NO_MINGW_LFS) && (!defined(__STRICT_ANSI__) || defined(__MINGW64_VERSION_MAJOR))
+		// there are 64-bit versions of fseek/ftell, let's use them
+		typedef off64_t length_type;
+
+		fseeko64(file, 0, SEEK_END);
+		length_type length = ftello64(file);
+		fseeko64(file, 0, SEEK_SET);
+	#else
+		// if this is a 32-bit OS, long is enough; if this is a unix system, long is 64-bit, which is enough; otherwise we can't do anything anyway.
+		typedef long length_type;
+
+		fseek(file, 0, SEEK_END);
+		length_type length = ftell(file);
+		fseek(file, 0, SEEK_SET);
+	#endif
+
+		// check for I/O errors
+		if (length < 0) return status_io_error;
+
+		// check for overflow
+		size_t result = static_cast<size_t>(length);
+
+		if (static_cast<length_type>(result) != length) return status_out_of_memory;
+
+		// finalize
+		out_result = result;
+
+		return status_ok;
+	}
+
+	// This function assumes that buffer has extra sizeof(char_t) writable bytes after size
+	PUGI_IMPL_FN size_t zero_terminate_buffer(void* buffer, size_t size, xml_encoding encoding)
+	{
+		// We only need to zero-terminate if encoding conversion does not do it for us
+	#ifdef PUGIXML_WCHAR_MODE
+		xml_encoding wchar_encoding = get_wchar_encoding();
+
+		if (encoding == wchar_encoding || need_endian_swap_utf(encoding, wchar_encoding))
+		{
+			size_t length = size / sizeof(char_t);
+
+			static_cast<char_t*>(buffer)[length] = 0;
+			return (length + 1) * sizeof(char_t);
+		}
+	#else
+		if (encoding == encoding_utf8)
+		{
+			static_cast<char*>(buffer)[size] = 0;
+			return size + 1;
+		}
+	#endif
+
+		return size;
+	}
+
+	PUGI_IMPL_FN xml_parse_result load_file_impl(xml_document_struct* doc, FILE* file, unsigned int options, xml_encoding encoding, char_t** out_buffer)
+	{
+		if (!file) return make_parse_result(status_file_not_found);
+
+		// get file size (can result in I/O errors)
+		size_t size = 0;
+		xml_parse_status size_status = get_file_size(file, size);
+		if (size_status != status_ok) return make_parse_result(size_status);
+
+		size_t max_suffix_size = sizeof(char_t);
+
+		// allocate buffer for the whole file
+		char* contents = static_cast<char*>(xml_memory::allocate(size + max_suffix_size));
+		if (!contents) return make_parse_result(status_out_of_memory);
+
+		// read file in memory
+		size_t read_size = fread(contents, 1, size, file);
+
+		if (read_size != size)
+		{
+			xml_memory::deallocate(contents);
+			return make_parse_result(status_io_error);
+		}
+
+		xml_encoding real_encoding = get_buffer_encoding(encoding, contents, size);
+
+		return load_buffer_impl(doc, doc, contents, zero_terminate_buffer(contents, size, real_encoding), options, real_encoding, true, true, out_buffer);
+	}
+
+	PUGI_IMPL_FN void close_file(FILE* file)
+	{
+		fclose(file);
+	}
+
+#ifndef PUGIXML_NO_STL
+	template <typename T> struct xml_stream_chunk
+	{
+		static xml_stream_chunk* create()
+		{
+			void* memory = xml_memory::allocate(sizeof(xml_stream_chunk));
+			if (!memory) return 0;
+
+			return new (memory) xml_stream_chunk();
+		}
+
+		static void destroy(xml_stream_chunk* chunk)
+		{
+			// free chunk chain
+			while (chunk)
+			{
+				xml_stream_chunk* next_ = chunk->next;
+
+				xml_memory::deallocate(chunk);
+
+				chunk = next_;
+			}
+		}
+
+		xml_stream_chunk(): next(0), size(0)
+		{
+		}
+
+		xml_stream_chunk* next;
+		size_t size;
+
+		T data[xml_memory_page_size / sizeof(T)];
+	};
+
+	template <typename T> PUGI_IMPL_FN xml_parse_status load_stream_data_noseek(std::basic_istream<T>& stream, void** out_buffer, size_t* out_size)
+	{
+		auto_deleter<xml_stream_chunk<T> > chunks(0, xml_stream_chunk<T>::destroy);
+
+		// read file to a chunk list
+		size_t total = 0;
+		xml_stream_chunk<T>* last = 0;
+
+		while (!stream.eof())
+		{
+			// allocate new chunk
+			xml_stream_chunk<T>* chunk = xml_stream_chunk<T>::create();
+			if (!chunk) return status_out_of_memory;
+
+			// append chunk to list
+			if (last) last = last->next = chunk;
+			else chunks.data = last = chunk;
+
+			// read data to chunk
+			stream.read(chunk->data, static_cast<std::streamsize>(sizeof(chunk->data) / sizeof(T)));
+			chunk->size = static_cast<size_t>(stream.gcount()) * sizeof(T);
+
+			// read may set failbit | eofbit in case gcount() is less than read length, so check for other I/O errors
+			if (stream.bad() || (!stream.eof() && stream.fail())) return status_io_error;
+
+			// guard against huge files (chunk size is small enough to make this overflow check work)
+			if (total + chunk->size < total) return status_out_of_memory;
+			total += chunk->size;
+		}
+
+		size_t max_suffix_size = sizeof(char_t);
+
+		// copy chunk list to a contiguous buffer
+		char* buffer = static_cast<char*>(xml_memory::allocate(total + max_suffix_size));
+		if (!buffer) return status_out_of_memory;
+
+		char* write = buffer;
+
+		for (xml_stream_chunk<T>* chunk = chunks.data; chunk; chunk = chunk->next)
+		{
+			assert(write + chunk->size <= buffer + total);
+			memcpy(write, chunk->data, chunk->size);
+			write += chunk->size;
+		}
+
+		assert(write == buffer + total);
+
+		// return buffer
+		*out_buffer = buffer;
+		*out_size = total;
+
+		return status_ok;
+	}
+
+	template <typename T> PUGI_IMPL_FN xml_parse_status load_stream_data_seek(std::basic_istream<T>& stream, void** out_buffer, size_t* out_size)
+	{
+		// get length of remaining data in stream
+		typename std::basic_istream<T>::pos_type pos = stream.tellg();
+		stream.seekg(0, std::ios::end);
+		std::streamoff length = stream.tellg() - pos;
+		stream.seekg(pos);
+
+		if (stream.fail() || pos < 0) return status_io_error;
+
+		// guard against huge files
+		size_t read_length = static_cast<size_t>(length);
+
+		if (static_cast<std::streamsize>(read_length) != length || length < 0) return status_out_of_memory;
+
+		size_t max_suffix_size = sizeof(char_t);
+
+		// read stream data into memory (guard against stream exceptions with buffer holder)
+		auto_deleter<void> buffer(xml_memory::allocate(read_length * sizeof(T) + max_suffix_size), xml_memory::deallocate);
+		if (!buffer.data) return status_out_of_memory;
+
+		stream.read(static_cast<T*>(buffer.data), static_cast<std::streamsize>(read_length));
+
+		// read may set failbit | eofbit in case gcount() is less than read_length (i.e. line ending conversion), so check for other I/O errors
+		if (stream.bad() || (!stream.eof() && stream.fail())) return status_io_error;
+
+		// return buffer
+		size_t actual_length = static_cast<size_t>(stream.gcount());
+		assert(actual_length <= read_length);
+
+		*out_buffer = buffer.release();
+		*out_size = actual_length * sizeof(T);
+
+		return status_ok;
+	}
+
+	template <typename T> PUGI_IMPL_FN xml_parse_result load_stream_impl(xml_document_struct* doc, std::basic_istream<T>& stream, unsigned int options, xml_encoding encoding, char_t** out_buffer)
+	{
+		void* buffer = 0;
+		size_t size = 0;
+		xml_parse_status status = status_ok;
+
+		// if stream has an error bit set, bail out (otherwise tellg() can fail and we'll clear error bits)
+		if (stream.fail()) return make_parse_result(status_io_error);
+
+		// load stream to memory (using seek-based implementation if possible, since it's faster and takes less memory)
+		if (stream.tellg() < 0)
+		{
+			stream.clear(); // clear error flags that could be set by a failing tellg
+			status = load_stream_data_noseek(stream, &buffer, &size);
+		}
+		else
+			status = load_stream_data_seek(stream, &buffer, &size);
+
+		if (status != status_ok) return make_parse_result(status);
+
+		xml_encoding real_encoding = get_buffer_encoding(encoding, buffer, size);
+
+		return load_buffer_impl(doc, doc, buffer, zero_terminate_buffer(buffer, size, real_encoding), options, real_encoding, true, true, out_buffer);
+	}
+#endif
+
+#if defined(PUGI_IMPL_MSVC_CRT_VERSION) || defined(__BORLANDC__) || (defined(__MINGW32__) && (!defined(__STRICT_ANSI__) || defined(__MINGW64_VERSION_MAJOR)))
+	PUGI_IMPL_FN FILE* open_file_wide(const wchar_t* path, const wchar_t* mode)
+	{
+#if defined(PUGI_IMPL_MSVC_CRT_VERSION) && PUGI_IMPL_MSVC_CRT_VERSION >= 1400
+		FILE* file = 0;
+		return _wfopen_s(&file, path, mode) == 0 ? file : 0;
+#else
+		return _wfopen(path, mode);
+#endif
+	}
+#else
+	PUGI_IMPL_FN char* convert_path_heap(const wchar_t* str)
+	{
+		assert(str);
+
+		// first pass: get length in utf8 characters
+		size_t length = strlength_wide(str);
+		size_t size = as_utf8_begin(str, length);
+
+		// allocate resulting string
+		char* result = static_cast<char*>(xml_memory::allocate(size + 1));
+		if (!result) return 0;
+
+		// second pass: convert to utf8
+		as_utf8_end(result, size, str, length);
+
+		// zero-terminate
+		result[size] = 0;
+
+		return result;
+	}
+
+	PUGI_IMPL_FN FILE* open_file_wide(const wchar_t* path, const wchar_t* mode)
+	{
+		// there is no standard function to open wide paths, so our best bet is to try utf8 path
+		char* path_utf8 = convert_path_heap(path);
+		if (!path_utf8) return 0;
+
+		// convert mode to ASCII (we mirror _wfopen interface)
+		char mode_ascii[4] = {0};
+		for (size_t i = 0; mode[i]; ++i) mode_ascii[i] = static_cast<char>(mode[i]);
+
+		// try to open the utf8 path
+		FILE* result = fopen(path_utf8, mode_ascii);
+
+		// free dummy buffer
+		xml_memory::deallocate(path_utf8);
+
+		return result;
+	}
+#endif
+
+	PUGI_IMPL_FN FILE* open_file(const char* path, const char* mode)
+	{
+#if defined(PUGI_IMPL_MSVC_CRT_VERSION) && PUGI_IMPL_MSVC_CRT_VERSION >= 1400
+		FILE* file = 0;
+		return fopen_s(&file, path, mode) == 0 ? file : 0;
+#else
+		return fopen(path, mode);
+#endif
+	}
+
+	PUGI_IMPL_FN bool save_file_impl(const xml_document& doc, FILE* file, const char_t* indent, unsigned int flags, xml_encoding encoding)
+	{
+		if (!file) return false;
+
+		xml_writer_file writer(file);
+		doc.save(writer, indent, flags, encoding);
+
+		return fflush(file) == 0 && ferror(file) == 0;
+	}
+
+	struct name_null_sentry
+	{
+		xml_node_struct* node;
+		char_t* name;
+
+		name_null_sentry(xml_node_struct* node_): node(node_), name(node_->name)
+		{
+			node->name = 0;
+		}
+
+		~name_null_sentry()
+		{
+			node->name = name;
+		}
+	};
+PUGI_IMPL_NS_END
+
+namespace pugi
+{
+	PUGI_IMPL_FN xml_writer::~xml_writer()
+	{
+	}
+
+	PUGI_IMPL_FN xml_writer_file::xml_writer_file(void* file_): file(file_)
+	{
+	}
+
+	PUGI_IMPL_FN void xml_writer_file::write(const void* data, size_t size)
+	{
+		size_t result = fwrite(data, 1, size, static_cast<FILE*>(file));
+		(void)!result; // unfortunately we can't do proper error handling here
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN xml_writer_stream::xml_writer_stream(std::basic_ostream<char, std::char_traits<char> >& stream): narrow_stream(&stream), wide_stream(0)
+	{
+	}
+
+	PUGI_IMPL_FN xml_writer_stream::xml_writer_stream(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& stream): narrow_stream(0), wide_stream(&stream)
+	{
+	}
+
+	PUGI_IMPL_FN void xml_writer_stream::write(const void* data, size_t size)
+	{
+		if (narrow_stream)
+		{
+			assert(!wide_stream);
+			narrow_stream->write(reinterpret_cast<const char*>(data), static_cast<std::streamsize>(size));
+		}
+		else
+		{
+			assert(wide_stream);
+			assert(size % sizeof(wchar_t) == 0);
+
+			wide_stream->write(reinterpret_cast<const wchar_t*>(data), static_cast<std::streamsize>(size / sizeof(wchar_t)));
+		}
+	}
+#endif
+
+	PUGI_IMPL_FN xml_tree_walker::xml_tree_walker(): _depth(0)
+	{
+	}
+
+	PUGI_IMPL_FN xml_tree_walker::~xml_tree_walker()
+	{
+	}
+
+	PUGI_IMPL_FN int xml_tree_walker::depth() const
+	{
+		return _depth;
+	}
+
+	PUGI_IMPL_FN bool xml_tree_walker::begin(xml_node&)
+	{
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xml_tree_walker::end(xml_node&)
+	{
+		return true;
+	}
+
+	PUGI_IMPL_FN xml_attribute::xml_attribute(): _attr(0)
+	{
+	}
+
+	PUGI_IMPL_FN xml_attribute::xml_attribute(xml_attribute_struct* attr): _attr(attr)
+	{
+	}
+
+	PUGI_IMPL_FN static void unspecified_bool_xml_attribute(xml_attribute***)
+	{
+	}
+
+	PUGI_IMPL_FN xml_attribute::operator xml_attribute::unspecified_bool_type() const
+	{
+		return _attr ? unspecified_bool_xml_attribute : 0;
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator!() const
+	{
+		return !_attr;
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator==(const xml_attribute& r) const
+	{
+		return (_attr == r._attr);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator!=(const xml_attribute& r) const
+	{
+		return (_attr != r._attr);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator<(const xml_attribute& r) const
+	{
+		return (_attr < r._attr);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator>(const xml_attribute& r) const
+	{
+		return (_attr > r._attr);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator<=(const xml_attribute& r) const
+	{
+		return (_attr <= r._attr);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::operator>=(const xml_attribute& r) const
+	{
+		return (_attr >= r._attr);
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_attribute::next_attribute() const
+	{
+		if (!_attr) return xml_attribute();
+		return xml_attribute(_attr->next_attribute);
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_attribute::previous_attribute() const
+	{
+		if (!_attr) return xml_attribute();
+		xml_attribute_struct* prev = _attr->prev_attribute_c;
+		return prev->next_attribute ? xml_attribute(prev) : xml_attribute();
+	}
+
+	PUGI_IMPL_FN const char_t* xml_attribute::as_string(const char_t* def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? value : def;
+	}
+
+	PUGI_IMPL_FN int xml_attribute::as_int(int def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_int(value) : def;
+	}
+
+	PUGI_IMPL_FN unsigned int xml_attribute::as_uint(unsigned int def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_uint(value) : def;
+	}
+
+	PUGI_IMPL_FN double xml_attribute::as_double(double def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_double(value) : def;
+	}
+
+	PUGI_IMPL_FN float xml_attribute::as_float(float def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_float(value) : def;
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::as_bool(bool def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_bool(value) : def;
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN long long xml_attribute::as_llong(long long def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_llong(value) : def;
+	}
+
+	PUGI_IMPL_FN unsigned long long xml_attribute::as_ullong(unsigned long long def) const
+	{
+		if (!_attr) return def;
+		const char_t* value = _attr->value;
+		return value ? impl::get_value_ullong(value) : def;
+	}
+#endif
+
+	PUGI_IMPL_FN bool xml_attribute::empty() const
+	{
+		return !_attr;
+	}
+
+	PUGI_IMPL_FN const char_t* xml_attribute::name() const
+	{
+		if (!_attr) return PUGIXML_TEXT("");
+		const char_t* name = _attr->name;
+		return name ? name : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const char_t* xml_attribute::value() const
+	{
+		if (!_attr) return PUGIXML_TEXT("");
+		const char_t* value = _attr->value;
+		return value ? value : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN size_t xml_attribute::hash_value() const
+	{
+		return static_cast<size_t>(reinterpret_cast<uintptr_t>(_attr) / sizeof(xml_attribute_struct));
+	}
+
+	PUGI_IMPL_FN xml_attribute_struct* xml_attribute::internal_object() const
+	{
+		return _attr;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(const char_t* rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(int rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(unsigned int rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(long rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(unsigned long rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(double rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(float rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(bool rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(long long rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute::operator=(unsigned long long rhs)
+	{
+		set_value(rhs);
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN bool xml_attribute::set_name(const char_t* rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::strcpy_insitu(_attr->name, _attr->header, impl::xml_memory_page_name_allocated_mask, rhs, impl::strlength(rhs));
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_name(const char_t* rhs, size_t size)
+	{
+		if (!_attr) return false;
+
+		return impl::strcpy_insitu(_attr->name, _attr->header, impl::xml_memory_page_name_allocated_mask, rhs, size);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(const char_t* rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::strcpy_insitu(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, impl::strlength(rhs));
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(const char_t* rhs, size_t size)
+	{
+		if (!_attr) return false;
+
+		return impl::strcpy_insitu(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, size);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(int rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned int>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(unsigned int rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned int>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, false);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(long rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned long>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(unsigned long rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned long>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, false);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(double rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_convert(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, default_double_precision);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(double rhs, int precision)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_convert(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, precision);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(float rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_convert(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, default_float_precision);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(float rhs, int precision)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_convert(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, precision);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(bool rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_bool(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs);
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN bool xml_attribute::set_value(long long rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned long long>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0);
+	}
+
+	PUGI_IMPL_FN bool xml_attribute::set_value(unsigned long long rhs)
+	{
+		if (!_attr) return false;
+
+		return impl::set_value_integer<unsigned long long>(_attr->value, _attr->header, impl::xml_memory_page_value_allocated_mask, rhs, false);
+	}
+#endif
+
+#ifdef __BORLANDC__
+	PUGI_IMPL_FN bool operator&&(const xml_attribute& lhs, bool rhs)
+	{
+		return (bool)lhs && rhs;
+	}
+
+	PUGI_IMPL_FN bool operator||(const xml_attribute& lhs, bool rhs)
+	{
+		return (bool)lhs || rhs;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_node::xml_node(): _root(0)
+	{
+	}
+
+	PUGI_IMPL_FN xml_node::xml_node(xml_node_struct* p): _root(p)
+	{
+	}
+
+	PUGI_IMPL_FN static void unspecified_bool_xml_node(xml_node***)
+	{
+	}
+
+	PUGI_IMPL_FN xml_node::operator xml_node::unspecified_bool_type() const
+	{
+		return _root ? unspecified_bool_xml_node : 0;
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator!() const
+	{
+		return !_root;
+	}
+
+	PUGI_IMPL_FN xml_node::iterator xml_node::begin() const
+	{
+		return iterator(_root ? _root->first_child + 0 : 0, _root);
+	}
+
+	PUGI_IMPL_FN xml_node::iterator xml_node::end() const
+	{
+		return iterator(0, _root);
+	}
+
+	PUGI_IMPL_FN xml_node::attribute_iterator xml_node::attributes_begin() const
+	{
+		return attribute_iterator(_root ? _root->first_attribute + 0 : 0, _root);
+	}
+
+	PUGI_IMPL_FN xml_node::attribute_iterator xml_node::attributes_end() const
+	{
+		return attribute_iterator(0, _root);
+	}
+
+	PUGI_IMPL_FN xml_object_range<xml_node_iterator> xml_node::children() const
+	{
+		return xml_object_range<xml_node_iterator>(begin(), end());
+	}
+
+	PUGI_IMPL_FN xml_object_range<xml_named_node_iterator> xml_node::children(const char_t* name_) const
+	{
+		return xml_object_range<xml_named_node_iterator>(xml_named_node_iterator(child(name_)._root, _root, name_), xml_named_node_iterator(0, _root, name_));
+	}
+
+	PUGI_IMPL_FN xml_object_range<xml_attribute_iterator> xml_node::attributes() const
+	{
+		return xml_object_range<xml_attribute_iterator>(attributes_begin(), attributes_end());
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator==(const xml_node& r) const
+	{
+		return (_root == r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator!=(const xml_node& r) const
+	{
+		return (_root != r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator<(const xml_node& r) const
+	{
+		return (_root < r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator>(const xml_node& r) const
+	{
+		return (_root > r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator<=(const xml_node& r) const
+	{
+		return (_root <= r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::operator>=(const xml_node& r) const
+	{
+		return (_root >= r._root);
+	}
+
+	PUGI_IMPL_FN bool xml_node::empty() const
+	{
+		return !_root;
+	}
+
+	PUGI_IMPL_FN const char_t* xml_node::name() const
+	{
+		if (!_root) return PUGIXML_TEXT("");
+		const char_t* name = _root->name;
+		return name ? name : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN xml_node_type xml_node::type() const
+	{
+		return _root ? PUGI_IMPL_NODETYPE(_root) : node_null;
+	}
+
+	PUGI_IMPL_FN const char_t* xml_node::value() const
+	{
+		if (!_root) return PUGIXML_TEXT("");
+		const char_t* value = _root->value;
+		return value ? value : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::child(const char_t* name_) const
+	{
+		if (!_root) return xml_node();
+
+		for (xml_node_struct* i = _root->first_child; i; i = i->next_sibling)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+				return xml_node(i);
+		}
+
+		return xml_node();
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::attribute(const char_t* name_) const
+	{
+		if (!_root) return xml_attribute();
+
+		for (xml_attribute_struct* i = _root->first_attribute; i; i = i->next_attribute)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+				return xml_attribute(i);
+		}
+
+		return xml_attribute();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::next_sibling(const char_t* name_) const
+	{
+		if (!_root) return xml_node();
+
+		for (xml_node_struct* i = _root->next_sibling; i; i = i->next_sibling)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+				return xml_node(i);
+		}
+
+		return xml_node();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::next_sibling() const
+	{
+		return _root ? xml_node(_root->next_sibling) : xml_node();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::previous_sibling(const char_t* name_) const
+	{
+		if (!_root) return xml_node();
+
+		for (xml_node_struct* i = _root->prev_sibling_c; i->next_sibling; i = i->prev_sibling_c)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+				return xml_node(i);
+		}
+
+		return xml_node();
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::attribute(const char_t* name_, xml_attribute& hint_) const
+	{
+		xml_attribute_struct* hint = hint_._attr;
+
+		// if hint is not an attribute of node, behavior is not defined
+		assert(!hint || (_root && impl::is_attribute_of(hint, _root)));
+
+		if (!_root) return xml_attribute();
+
+		// optimistically search from hint up until the end
+		for (xml_attribute_struct* i = hint; i; i = i->next_attribute)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+			{
+				// update hint to maximize efficiency of searching for consecutive attributes
+				hint_._attr = i->next_attribute;
+
+				return xml_attribute(i);
+			}
+		}
+
+		// wrap around and search from the first attribute until the hint
+		// 'j' null pointer check is technically redundant, but it prevents a crash in case the assertion above fails
+		for (xml_attribute_struct* j = _root->first_attribute; j && j != hint; j = j->next_attribute)
+		{
+			const char_t* jname = j->name;
+			if (jname && impl::strequal(name_, jname))
+			{
+				// update hint to maximize efficiency of searching for consecutive attributes
+				hint_._attr = j->next_attribute;
+
+				return xml_attribute(j);
+			}
+		}
+
+		return xml_attribute();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::previous_sibling() const
+	{
+		if (!_root) return xml_node();
+		xml_node_struct* prev = _root->prev_sibling_c;
+		return prev->next_sibling ? xml_node(prev) : xml_node();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::parent() const
+	{
+		return _root ? xml_node(_root->parent) : xml_node();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::root() const
+	{
+		return _root ? xml_node(&impl::get_document(_root)) : xml_node();
+	}
+
+	PUGI_IMPL_FN xml_text xml_node::text() const
+	{
+		return xml_text(_root);
+	}
+
+	PUGI_IMPL_FN const char_t* xml_node::child_value() const
+	{
+		if (!_root) return PUGIXML_TEXT("");
+
+		// element nodes can have value if parse_embed_pcdata was used
+		if (PUGI_IMPL_NODETYPE(_root) == node_element && _root->value)
+			return _root->value;
+
+		for (xml_node_struct* i = _root->first_child; i; i = i->next_sibling)
+		{
+			const char_t* ivalue = i->value;
+			if (impl::is_text_node(i) && ivalue)
+				return ivalue;
+		}
+
+		return PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const char_t* xml_node::child_value(const char_t* name_) const
+	{
+		return child(name_).child_value();
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::first_attribute() const
+	{
+		if (!_root) return xml_attribute();
+		return xml_attribute(_root->first_attribute);
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::last_attribute() const
+	{
+		if (!_root) return xml_attribute();
+		xml_attribute_struct* first = _root->first_attribute;
+		return first ? xml_attribute(first->prev_attribute_c) : xml_attribute();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::first_child() const
+	{
+		if (!_root) return xml_node();
+		return xml_node(_root->first_child);
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::last_child() const
+	{
+		if (!_root) return xml_node();
+		xml_node_struct* first = _root->first_child;
+		return first ? xml_node(first->prev_sibling_c) : xml_node();
+	}
+
+	PUGI_IMPL_FN bool xml_node::set_name(const char_t* rhs)
+	{
+		xml_node_type type_ = _root ? PUGI_IMPL_NODETYPE(_root) : node_null;
+
+		if (type_ != node_element && type_ != node_pi && type_ != node_declaration)
+			return false;
+
+		return impl::strcpy_insitu(_root->name, _root->header, impl::xml_memory_page_name_allocated_mask, rhs, impl::strlength(rhs));
+	}
+
+	PUGI_IMPL_FN bool xml_node::set_name(const char_t* rhs, size_t size)
+	{
+		xml_node_type type_ = _root ? PUGI_IMPL_NODETYPE(_root) : node_null;
+
+		if (type_ != node_element && type_ != node_pi && type_ != node_declaration)
+			return false;
+
+		return impl::strcpy_insitu(_root->name, _root->header, impl::xml_memory_page_name_allocated_mask, rhs, size);
+	}
+
+	PUGI_IMPL_FN bool xml_node::set_value(const char_t* rhs)
+	{
+		xml_node_type type_ = _root ? PUGI_IMPL_NODETYPE(_root) : node_null;
+
+		if (type_ != node_pcdata && type_ != node_cdata && type_ != node_comment && type_ != node_pi && type_ != node_doctype)
+			return false;
+
+		return impl::strcpy_insitu(_root->value, _root->header, impl::xml_memory_page_value_allocated_mask, rhs, impl::strlength(rhs));
+	}
+
+	PUGI_IMPL_FN bool xml_node::set_value(const char_t* rhs, size_t size)
+	{
+		xml_node_type type_ = _root ? PUGI_IMPL_NODETYPE(_root) : node_null;
+
+		if (type_ != node_pcdata && type_ != node_cdata && type_ != node_comment && type_ != node_pi && type_ != node_doctype)
+			return false;
+
+		return impl::strcpy_insitu(_root->value, _root->header, impl::xml_memory_page_value_allocated_mask, rhs, size);
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::append_attribute(const char_t* name_)
+	{
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::append_attribute(a._attr, _root);
+
+		a.set_name(name_);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::prepend_attribute(const char_t* name_)
+	{
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::prepend_attribute(a._attr, _root);
+
+		a.set_name(name_);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::insert_attribute_after(const char_t* name_, const xml_attribute& attr)
+	{
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+		if (!attr || !impl::is_attribute_of(attr._attr, _root)) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::insert_attribute_after(a._attr, attr._attr, _root);
+
+		a.set_name(name_);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::insert_attribute_before(const char_t* name_, const xml_attribute& attr)
+	{
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+		if (!attr || !impl::is_attribute_of(attr._attr, _root)) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::insert_attribute_before(a._attr, attr._attr, _root);
+
+		a.set_name(name_);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::append_copy(const xml_attribute& proto)
+	{
+		if (!proto) return xml_attribute();
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::append_attribute(a._attr, _root);
+		impl::node_copy_attribute(a._attr, proto._attr);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::prepend_copy(const xml_attribute& proto)
+	{
+		if (!proto) return xml_attribute();
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::prepend_attribute(a._attr, _root);
+		impl::node_copy_attribute(a._attr, proto._attr);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::insert_copy_after(const xml_attribute& proto, const xml_attribute& attr)
+	{
+		if (!proto) return xml_attribute();
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+		if (!attr || !impl::is_attribute_of(attr._attr, _root)) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::insert_attribute_after(a._attr, attr._attr, _root);
+		impl::node_copy_attribute(a._attr, proto._attr);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_attribute xml_node::insert_copy_before(const xml_attribute& proto, const xml_attribute& attr)
+	{
+		if (!proto) return xml_attribute();
+		if (!impl::allow_insert_attribute(type())) return xml_attribute();
+		if (!attr || !impl::is_attribute_of(attr._attr, _root)) return xml_attribute();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_attribute();
+
+		xml_attribute a(impl::allocate_attribute(alloc));
+		if (!a) return xml_attribute();
+
+		impl::insert_attribute_before(a._attr, attr._attr, _root);
+		impl::node_copy_attribute(a._attr, proto._attr);
+
+		return a;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::append_child(xml_node_type type_)
+	{
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::append_node(n._root, _root);
+
+		if (type_ == node_declaration) n.set_name(PUGIXML_TEXT("xml"));
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::prepend_child(xml_node_type type_)
+	{
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::prepend_node(n._root, _root);
+
+		if (type_ == node_declaration) n.set_name(PUGIXML_TEXT("xml"));
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_child_before(xml_node_type type_, const xml_node& node)
+	{
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::insert_node_before(n._root, node._root);
+
+		if (type_ == node_declaration) n.set_name(PUGIXML_TEXT("xml"));
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_child_after(xml_node_type type_, const xml_node& node)
+	{
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::insert_node_after(n._root, node._root);
+
+		if (type_ == node_declaration) n.set_name(PUGIXML_TEXT("xml"));
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::append_child(const char_t* name_)
+	{
+		xml_node result = append_child(node_element);
+
+		result.set_name(name_);
+
+		return result;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::prepend_child(const char_t* name_)
+	{
+		xml_node result = prepend_child(node_element);
+
+		result.set_name(name_);
+
+		return result;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_child_after(const char_t* name_, const xml_node& node)
+	{
+		xml_node result = insert_child_after(node_element, node);
+
+		result.set_name(name_);
+
+		return result;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_child_before(const char_t* name_, const xml_node& node)
+	{
+		xml_node result = insert_child_before(node_element, node);
+
+		result.set_name(name_);
+
+		return result;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::append_copy(const xml_node& proto)
+	{
+		xml_node_type type_ = proto.type();
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::append_node(n._root, _root);
+		impl::node_copy_tree(n._root, proto._root);
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::prepend_copy(const xml_node& proto)
+	{
+		xml_node_type type_ = proto.type();
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::prepend_node(n._root, _root);
+		impl::node_copy_tree(n._root, proto._root);
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_copy_after(const xml_node& proto, const xml_node& node)
+	{
+		xml_node_type type_ = proto.type();
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::insert_node_after(n._root, node._root);
+		impl::node_copy_tree(n._root, proto._root);
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_copy_before(const xml_node& proto, const xml_node& node)
+	{
+		xml_node_type type_ = proto.type();
+		if (!impl::allow_insert_child(type(), type_)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		xml_node n(impl::allocate_node(alloc, type_));
+		if (!n) return xml_node();
+
+		impl::insert_node_before(n._root, node._root);
+		impl::node_copy_tree(n._root, proto._root);
+
+		return n;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::append_move(const xml_node& moved)
+	{
+		if (!impl::allow_move(*this, moved)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		// disable document_buffer_order optimization since moving nodes around changes document order without changing buffer pointers
+		impl::get_document(_root).header |= impl::xml_memory_page_contents_shared_mask;
+
+		impl::remove_node(moved._root);
+		impl::append_node(moved._root, _root);
+
+		return moved;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::prepend_move(const xml_node& moved)
+	{
+		if (!impl::allow_move(*this, moved)) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		// disable document_buffer_order optimization since moving nodes around changes document order without changing buffer pointers
+		impl::get_document(_root).header |= impl::xml_memory_page_contents_shared_mask;
+
+		impl::remove_node(moved._root);
+		impl::prepend_node(moved._root, _root);
+
+		return moved;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_move_after(const xml_node& moved, const xml_node& node)
+	{
+		if (!impl::allow_move(*this, moved)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+		if (moved._root == node._root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		// disable document_buffer_order optimization since moving nodes around changes document order without changing buffer pointers
+		impl::get_document(_root).header |= impl::xml_memory_page_contents_shared_mask;
+
+		impl::remove_node(moved._root);
+		impl::insert_node_after(moved._root, node._root);
+
+		return moved;
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::insert_move_before(const xml_node& moved, const xml_node& node)
+	{
+		if (!impl::allow_move(*this, moved)) return xml_node();
+		if (!node._root || node._root->parent != _root) return xml_node();
+		if (moved._root == node._root) return xml_node();
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return xml_node();
+
+		// disable document_buffer_order optimization since moving nodes around changes document order without changing buffer pointers
+		impl::get_document(_root).header |= impl::xml_memory_page_contents_shared_mask;
+
+		impl::remove_node(moved._root);
+		impl::insert_node_before(moved._root, node._root);
+
+		return moved;
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_attribute(const char_t* name_)
+	{
+		return remove_attribute(attribute(name_));
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_attribute(const xml_attribute& a)
+	{
+		if (!_root || !a._attr) return false;
+		if (!impl::is_attribute_of(a._attr, _root)) return false;
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return false;
+
+		impl::remove_attribute(a._attr, _root);
+		impl::destroy_attribute(a._attr, alloc);
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_attributes()
+	{
+		if (!_root) return false;
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return false;
+
+		for (xml_attribute_struct* attr = _root->first_attribute; attr; )
+		{
+			xml_attribute_struct* next = attr->next_attribute;
+
+			impl::destroy_attribute(attr, alloc);
+
+			attr = next;
+		}
+
+		_root->first_attribute = 0;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_child(const char_t* name_)
+	{
+		return remove_child(child(name_));
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_child(const xml_node& n)
+	{
+		if (!_root || !n._root || n._root->parent != _root) return false;
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return false;
+
+		impl::remove_node(n._root);
+		impl::destroy_node(n._root, alloc);
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xml_node::remove_children()
+	{
+		if (!_root) return false;
+
+		impl::xml_allocator& alloc = impl::get_allocator(_root);
+		if (!alloc.reserve()) return false;
+
+		for (xml_node_struct* cur = _root->first_child; cur; )
+		{
+			xml_node_struct* next = cur->next_sibling;
+
+			impl::destroy_node(cur, alloc);
+
+			cur = next;
+		}
+
+		_root->first_child = 0;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_node::append_buffer(const void* contents, size_t size, unsigned int options, xml_encoding encoding)
+	{
+		// append_buffer is only valid for elements/documents
+		if (!impl::allow_insert_child(type(), node_element)) return impl::make_parse_result(status_append_invalid_root);
+
+		// append buffer can not merge PCDATA into existing PCDATA nodes
+		if ((options & parse_merge_pcdata) != 0 && last_child().type() == node_pcdata) return impl::make_parse_result(status_append_invalid_root);
+
+		// get document node
+		impl::xml_document_struct* doc = &impl::get_document(_root);
+
+		// disable document_buffer_order optimization since in a document with multiple buffers comparing buffer pointers does not make sense
+		doc->header |= impl::xml_memory_page_contents_shared_mask;
+
+		// get extra buffer element (we'll store the document fragment buffer there so that we can deallocate it later)
+		impl::xml_memory_page* page = 0;
+		impl::xml_extra_buffer* extra = static_cast<impl::xml_extra_buffer*>(doc->allocate_memory(sizeof(impl::xml_extra_buffer) + sizeof(void*), page));
+		(void)page;
+
+		if (!extra) return impl::make_parse_result(status_out_of_memory);
+
+	#ifdef PUGIXML_COMPACT
+		// align the memory block to a pointer boundary; this is required for compact mode where memory allocations are only 4b aligned
+		// note that this requires up to sizeof(void*)-1 additional memory, which the allocation above takes into account
+		extra = reinterpret_cast<impl::xml_extra_buffer*>((reinterpret_cast<uintptr_t>(extra) + (sizeof(void*) - 1)) & ~(sizeof(void*) - 1));
+	#endif
+
+		// add extra buffer to the list
+		extra->buffer = 0;
+		extra->next = doc->extra_buffers;
+		doc->extra_buffers = extra;
+
+		// name of the root has to be NULL before parsing - otherwise closing node mismatches will not be detected at the top level
+		impl::name_null_sentry sentry(_root);
+
+		return impl::load_buffer_impl(doc, _root, const_cast<void*>(contents), size, options, encoding, false, false, &extra->buffer);
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::find_child_by_attribute(const char_t* name_, const char_t* attr_name, const char_t* attr_value) const
+	{
+		if (!_root) return xml_node();
+
+		for (xml_node_struct* i = _root->first_child; i; i = i->next_sibling)
+		{
+			const char_t* iname = i->name;
+			if (iname && impl::strequal(name_, iname))
+			{
+				for (xml_attribute_struct* a = i->first_attribute; a; a = a->next_attribute)
+				{
+					const char_t* aname = a->name;
+					if (aname && impl::strequal(attr_name, aname))
+					{
+						const char_t* avalue = a->value;
+						if (impl::strequal(attr_value, avalue ? avalue : PUGIXML_TEXT("")))
+							return xml_node(i);
+					}
+				}
+			}
+		}
+
+		return xml_node();
+	}
+
+	PUGI_IMPL_FN xml_node xml_node::find_child_by_attribute(const char_t* attr_name, const char_t* attr_value) const
+	{
+		if (!_root) return xml_node();
+
+		for (xml_node_struct* i = _root->first_child; i; i = i->next_sibling)
+			for (xml_attribute_struct* a = i->first_attribute; a; a = a->next_attribute)
+			{
+				const char_t* aname = a->name;
+				if (aname && impl::strequal(attr_name, aname))
+				{
+					const char_t* avalue = a->value;
+					if (impl::strequal(attr_value, avalue ? avalue : PUGIXML_TEXT("")))
+						return xml_node(i);
+				}
+			}
+
+		return xml_node();
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN string_t xml_node::path(char_t delimiter) const
+	{
+		if (!_root) return string_t();
+
+		size_t offset = 0;
+
+		for (xml_node_struct* i = _root; i; i = i->parent)
+		{
+			const char_t* iname = i->name;
+			offset += (i != _root);
+			offset += iname ? impl::strlength(iname) : 0;
+		}
+
+		string_t result;
+		result.resize(offset);
+
+		for (xml_node_struct* j = _root; j; j = j->parent)
+		{
+			if (j != _root)
+				result[--offset] = delimiter;
+
+			const char_t* jname = j->name;
+			if (jname)
+			{
+				size_t length = impl::strlength(jname);
+
+				offset -= length;
+				memcpy(&result[offset], jname, length * sizeof(char_t));
+			}
+		}
+
+		assert(offset == 0);
+
+		return result;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_node xml_node::first_element_by_path(const char_t* path_, char_t delimiter) const
+	{
+		xml_node context = path_[0] == delimiter ? root() : *this;
+
+		if (!context._root) return xml_node();
+
+		const char_t* path_segment = path_;
+
+		while (*path_segment == delimiter) ++path_segment;
+
+		const char_t* path_segment_end = path_segment;
+
+		while (*path_segment_end && *path_segment_end != delimiter) ++path_segment_end;
+
+		if (path_segment == path_segment_end) return context;
+
+		const char_t* next_segment = path_segment_end;
+
+		while (*next_segment == delimiter) ++next_segment;
+
+		if (*path_segment == '.' && path_segment + 1 == path_segment_end)
+			return context.first_element_by_path(next_segment, delimiter);
+		else if (*path_segment == '.' && *(path_segment+1) == '.' && path_segment + 2 == path_segment_end)
+			return context.parent().first_element_by_path(next_segment, delimiter);
+		else
+		{
+			for (xml_node_struct* j = context._root->first_child; j; j = j->next_sibling)
+			{
+				const char_t* jname = j->name;
+				if (jname && impl::strequalrange(jname, path_segment, static_cast<size_t>(path_segment_end - path_segment)))
+				{
+					xml_node subsearch = xml_node(j).first_element_by_path(next_segment, delimiter);
+
+					if (subsearch) return subsearch;
+				}
+			}
+
+			return xml_node();
+		}
+	}
+
+	PUGI_IMPL_FN bool xml_node::traverse(xml_tree_walker& walker)
+	{
+		walker._depth = -1;
+
+		xml_node arg_begin(_root);
+		if (!walker.begin(arg_begin)) return false;
+
+		xml_node_struct* cur = _root ? _root->first_child + 0 : 0;
+
+		if (cur)
+		{
+			++walker._depth;
+
+			do
+			{
+				xml_node arg_for_each(cur);
+				if (!walker.for_each(arg_for_each))
+					return false;
+
+				if (cur->first_child)
+				{
+					++walker._depth;
+					cur = cur->first_child;
+				}
+				else if (cur->next_sibling)
+					cur = cur->next_sibling;
+				else
+				{
+					while (!cur->next_sibling && cur != _root && cur->parent)
+					{
+						--walker._depth;
+						cur = cur->parent;
+					}
+
+					if (cur != _root)
+						cur = cur->next_sibling;
+				}
+			}
+			while (cur && cur != _root);
+		}
+
+		assert(walker._depth == -1);
+
+		xml_node arg_end(_root);
+		return walker.end(arg_end);
+	}
+
+	PUGI_IMPL_FN size_t xml_node::hash_value() const
+	{
+		return static_cast<size_t>(reinterpret_cast<uintptr_t>(_root) / sizeof(xml_node_struct));
+	}
+
+	PUGI_IMPL_FN xml_node_struct* xml_node::internal_object() const
+	{
+		return _root;
+	}
+
+	PUGI_IMPL_FN void xml_node::print(xml_writer& writer, const char_t* indent, unsigned int flags, xml_encoding encoding, unsigned int depth) const
+	{
+		if (!_root) return;
+
+		impl::xml_buffered_writer buffered_writer(writer, encoding);
+
+		impl::node_output(buffered_writer, _root, indent, flags, depth);
+
+		buffered_writer.flush();
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN void xml_node::print(std::basic_ostream<char, std::char_traits<char> >& stream, const char_t* indent, unsigned int flags, xml_encoding encoding, unsigned int depth) const
+	{
+		xml_writer_stream writer(stream);
+
+		print(writer, indent, flags, encoding, depth);
+	}
+
+	PUGI_IMPL_FN void xml_node::print(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& stream, const char_t* indent, unsigned int flags, unsigned int depth) const
+	{
+		xml_writer_stream writer(stream);
+
+		print(writer, indent, flags, encoding_wchar, depth);
+	}
+#endif
+
+	PUGI_IMPL_FN ptrdiff_t xml_node::offset_debug() const
+	{
+		if (!_root) return -1;
+
+		impl::xml_document_struct& doc = impl::get_document(_root);
+
+		// we can determine the offset reliably only if there is exactly once parse buffer
+		if (!doc.buffer || doc.extra_buffers) return -1;
+
+		switch (type())
+		{
+		case node_document:
+			return 0;
+
+		case node_element:
+		case node_declaration:
+		case node_pi:
+			return _root->name && (_root->header & impl::xml_memory_page_name_allocated_or_shared_mask) == 0 ? _root->name - doc.buffer : -1;
+
+		case node_pcdata:
+		case node_cdata:
+		case node_comment:
+		case node_doctype:
+			return _root->value && (_root->header & impl::xml_memory_page_value_allocated_or_shared_mask) == 0 ? _root->value - doc.buffer : -1;
+
+		default:
+			assert(false && "Invalid node type"); // unreachable
+			return -1;
+		}
+	}
+
+#ifdef __BORLANDC__
+	PUGI_IMPL_FN bool operator&&(const xml_node& lhs, bool rhs)
+	{
+		return (bool)lhs && rhs;
+	}
+
+	PUGI_IMPL_FN bool operator||(const xml_node& lhs, bool rhs)
+	{
+		return (bool)lhs || rhs;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_text::xml_text(xml_node_struct* root): _root(root)
+	{
+	}
+
+	PUGI_IMPL_FN xml_node_struct* xml_text::_data() const
+	{
+		if (!_root || impl::is_text_node(_root)) return _root;
+
+		// element nodes can have value if parse_embed_pcdata was used
+		if (PUGI_IMPL_NODETYPE(_root) == node_element && _root->value)
+			return _root;
+
+		for (xml_node_struct* node = _root->first_child; node; node = node->next_sibling)
+			if (impl::is_text_node(node))
+				return node;
+
+		return 0;
+	}
+
+	PUGI_IMPL_FN xml_node_struct* xml_text::_data_new()
+	{
+		xml_node_struct* d = _data();
+		if (d) return d;
+
+		return xml_node(_root).append_child(node_pcdata).internal_object();
+	}
+
+	PUGI_IMPL_FN xml_text::xml_text(): _root(0)
+	{
+	}
+
+	PUGI_IMPL_FN static void unspecified_bool_xml_text(xml_text***)
+	{
+	}
+
+	PUGI_IMPL_FN xml_text::operator xml_text::unspecified_bool_type() const
+	{
+		return _data() ? unspecified_bool_xml_text : 0;
+	}
+
+	PUGI_IMPL_FN bool xml_text::operator!() const
+	{
+		return !_data();
+	}
+
+	PUGI_IMPL_FN bool xml_text::empty() const
+	{
+		return _data() == 0;
+	}
+
+	PUGI_IMPL_FN const char_t* xml_text::get() const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return PUGIXML_TEXT("");
+		const char_t* value = d->value;
+		return value ? value : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const char_t* xml_text::as_string(const char_t* def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? value : def;
+	}
+
+	PUGI_IMPL_FN int xml_text::as_int(int def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_int(value) : def;
+	}
+
+	PUGI_IMPL_FN unsigned int xml_text::as_uint(unsigned int def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_uint(value) : def;
+	}
+
+	PUGI_IMPL_FN double xml_text::as_double(double def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_double(value) : def;
+	}
+
+	PUGI_IMPL_FN float xml_text::as_float(float def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_float(value) : def;
+	}
+
+	PUGI_IMPL_FN bool xml_text::as_bool(bool def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_bool(value) : def;
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN long long xml_text::as_llong(long long def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_llong(value) : def;
+	}
+
+	PUGI_IMPL_FN unsigned long long xml_text::as_ullong(unsigned long long def) const
+	{
+		xml_node_struct* d = _data();
+		if (!d) return def;
+		const char_t* value = d->value;
+		return value ? impl::get_value_ullong(value) : def;
+	}
+#endif
+
+	PUGI_IMPL_FN bool xml_text::set(const char_t* rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::strcpy_insitu(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, impl::strlength(rhs)) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(const char_t* rhs, size_t size)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::strcpy_insitu(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, size) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(int rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned int>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(unsigned int rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned int>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, false) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(long rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned long>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(unsigned long rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned long>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, false) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(float rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_convert(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, default_float_precision) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(float rhs, int precision)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_convert(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, precision) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(double rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_convert(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, default_double_precision) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(double rhs, int precision)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_convert(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, precision) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(bool rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_bool(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs) : false;
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN bool xml_text::set(long long rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned long long>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, rhs < 0) : false;
+	}
+
+	PUGI_IMPL_FN bool xml_text::set(unsigned long long rhs)
+	{
+		xml_node_struct* dn = _data_new();
+
+		return dn ? impl::set_value_integer<unsigned long long>(dn->value, dn->header, impl::xml_memory_page_value_allocated_mask, rhs, false) : false;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(const char_t* rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(int rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(unsigned int rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(long rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(unsigned long rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(double rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(float rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(bool rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+#ifdef PUGIXML_HAS_LONG_LONG
+	PUGI_IMPL_FN xml_text& xml_text::operator=(long long rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_text& xml_text::operator=(unsigned long long rhs)
+	{
+		set(rhs);
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_node xml_text::data() const
+	{
+		return xml_node(_data());
+	}
+
+#ifdef __BORLANDC__
+	PUGI_IMPL_FN bool operator&&(const xml_text& lhs, bool rhs)
+	{
+		return (bool)lhs && rhs;
+	}
+
+	PUGI_IMPL_FN bool operator||(const xml_text& lhs, bool rhs)
+	{
+		return (bool)lhs || rhs;
+	}
+#endif
+
+	PUGI_IMPL_FN xml_node_iterator::xml_node_iterator()
+	{
+	}
+
+	PUGI_IMPL_FN xml_node_iterator::xml_node_iterator(const xml_node& node): _wrap(node), _parent(node.parent())
+	{
+	}
+
+	PUGI_IMPL_FN xml_node_iterator::xml_node_iterator(xml_node_struct* ref, xml_node_struct* parent): _wrap(ref), _parent(parent)
+	{
+	}
+
+	PUGI_IMPL_FN bool xml_node_iterator::operator==(const xml_node_iterator& rhs) const
+	{
+		return _wrap._root == rhs._wrap._root && _parent._root == rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN bool xml_node_iterator::operator!=(const xml_node_iterator& rhs) const
+	{
+		return _wrap._root != rhs._wrap._root || _parent._root != rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN xml_node& xml_node_iterator::operator*() const
+	{
+		assert(_wrap._root);
+		return _wrap;
+	}
+
+	PUGI_IMPL_FN xml_node* xml_node_iterator::operator->() const
+	{
+		assert(_wrap._root);
+		return const_cast<xml_node*>(&_wrap); // BCC5 workaround
+	}
+
+	PUGI_IMPL_FN xml_node_iterator& xml_node_iterator::operator++()
+	{
+		assert(_wrap._root);
+		_wrap._root = _wrap._root->next_sibling;
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_node_iterator xml_node_iterator::operator++(int)
+	{
+		xml_node_iterator temp = *this;
+		++*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_node_iterator& xml_node_iterator::operator--()
+	{
+		_wrap = _wrap._root ? _wrap.previous_sibling() : _parent.last_child();
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_node_iterator xml_node_iterator::operator--(int)
+	{
+		xml_node_iterator temp = *this;
+		--*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator::xml_attribute_iterator()
+	{
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator::xml_attribute_iterator(const xml_attribute& attr, const xml_node& parent): _wrap(attr), _parent(parent)
+	{
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator::xml_attribute_iterator(xml_attribute_struct* ref, xml_node_struct* parent): _wrap(ref), _parent(parent)
+	{
+	}
+
+	PUGI_IMPL_FN bool xml_attribute_iterator::operator==(const xml_attribute_iterator& rhs) const
+	{
+		return _wrap._attr == rhs._wrap._attr && _parent._root == rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN bool xml_attribute_iterator::operator!=(const xml_attribute_iterator& rhs) const
+	{
+		return _wrap._attr != rhs._wrap._attr || _parent._root != rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN xml_attribute& xml_attribute_iterator::operator*() const
+	{
+		assert(_wrap._attr);
+		return _wrap;
+	}
+
+	PUGI_IMPL_FN xml_attribute* xml_attribute_iterator::operator->() const
+	{
+		assert(_wrap._attr);
+		return const_cast<xml_attribute*>(&_wrap); // BCC5 workaround
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator& xml_attribute_iterator::operator++()
+	{
+		assert(_wrap._attr);
+		_wrap._attr = _wrap._attr->next_attribute;
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator xml_attribute_iterator::operator++(int)
+	{
+		xml_attribute_iterator temp = *this;
+		++*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator& xml_attribute_iterator::operator--()
+	{
+		_wrap = _wrap._attr ? _wrap.previous_attribute() : _parent.last_attribute();
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_attribute_iterator xml_attribute_iterator::operator--(int)
+	{
+		xml_attribute_iterator temp = *this;
+		--*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator::xml_named_node_iterator(): _name(0)
+	{
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator::xml_named_node_iterator(const xml_node& node, const char_t* name): _wrap(node), _parent(node.parent()), _name(name)
+	{
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator::xml_named_node_iterator(xml_node_struct* ref, xml_node_struct* parent, const char_t* name): _wrap(ref), _parent(parent), _name(name)
+	{
+	}
+
+	PUGI_IMPL_FN bool xml_named_node_iterator::operator==(const xml_named_node_iterator& rhs) const
+	{
+		return _wrap._root == rhs._wrap._root && _parent._root == rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN bool xml_named_node_iterator::operator!=(const xml_named_node_iterator& rhs) const
+	{
+		return _wrap._root != rhs._wrap._root || _parent._root != rhs._parent._root;
+	}
+
+	PUGI_IMPL_FN xml_node& xml_named_node_iterator::operator*() const
+	{
+		assert(_wrap._root);
+		return _wrap;
+	}
+
+	PUGI_IMPL_FN xml_node* xml_named_node_iterator::operator->() const
+	{
+		assert(_wrap._root);
+		return const_cast<xml_node*>(&_wrap); // BCC5 workaround
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator& xml_named_node_iterator::operator++()
+	{
+		assert(_wrap._root);
+		_wrap = _wrap.next_sibling(_name);
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator xml_named_node_iterator::operator++(int)
+	{
+		xml_named_node_iterator temp = *this;
+		++*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator& xml_named_node_iterator::operator--()
+	{
+		if (_wrap._root)
+			_wrap = _wrap.previous_sibling(_name);
+		else
+		{
+			_wrap = _parent.last_child();
+
+			if (!impl::strequal(_wrap.name(), _name))
+				_wrap = _wrap.previous_sibling(_name);
+		}
+
+		return *this;
+	}
+
+	PUGI_IMPL_FN xml_named_node_iterator xml_named_node_iterator::operator--(int)
+	{
+		xml_named_node_iterator temp = *this;
+		--*this;
+		return temp;
+	}
+
+	PUGI_IMPL_FN xml_parse_result::xml_parse_result(): status(status_internal_error), offset(0), encoding(encoding_auto)
+	{
+	}
+
+	PUGI_IMPL_FN xml_parse_result::operator bool() const
+	{
+		return status == status_ok;
+	}
+
+	PUGI_IMPL_FN const char* xml_parse_result::description() const
+	{
+		switch (status)
+		{
+		case status_ok: return "No error";
+
+		case status_file_not_found: return "File was not found";
+		case status_io_error: return "Error reading from file/stream";
+		case status_out_of_memory: return "Could not allocate memory";
+		case status_internal_error: return "Internal error occurred";
+
+		case status_unrecognized_tag: return "Could not determine tag type";
+
+		case status_bad_pi: return "Error parsing document declaration/processing instruction";
+		case status_bad_comment: return "Error parsing comment";
+		case status_bad_cdata: return "Error parsing CDATA section";
+		case status_bad_doctype: return "Error parsing document type declaration";
+		case status_bad_pcdata: return "Error parsing PCDATA section";
+		case status_bad_start_element: return "Error parsing start element tag";
+		case status_bad_attribute: return "Error parsing element attribute";
+		case status_bad_end_element: return "Error parsing end element tag";
+		case status_end_element_mismatch: return "Start-end tags mismatch";
+
+		case status_append_invalid_root: return "Unable to append nodes: root is not an element or document";
+
+		case status_no_document_element: return "No document element found";
+
+		default: return "Unknown error";
+		}
+	}
+
+	PUGI_IMPL_FN xml_document::xml_document(): _buffer(0)
+	{
+		_create();
+	}
+
+	PUGI_IMPL_FN xml_document::~xml_document()
+	{
+		_destroy();
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN xml_document::xml_document(xml_document&& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT: _buffer(0)
+	{
+		_create();
+		_move(rhs);
+	}
+
+	PUGI_IMPL_FN xml_document& xml_document::operator=(xml_document&& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT
+	{
+		if (this == &rhs) return *this;
+
+		_destroy();
+		_create();
+		_move(rhs);
+
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN void xml_document::reset()
+	{
+		_destroy();
+		_create();
+	}
+
+	PUGI_IMPL_FN void xml_document::reset(const xml_document& proto)
+	{
+		reset();
+
+		impl::node_copy_tree(_root, proto._root);
+	}
+
+	PUGI_IMPL_FN void xml_document::_create()
+	{
+		assert(!_root);
+
+	#ifdef PUGIXML_COMPACT
+		// space for page marker for the first page (uint32_t), rounded up to pointer size; assumes pointers are at least 32-bit
+		const size_t page_offset = sizeof(void*);
+	#else
+		const size_t page_offset = 0;
+	#endif
+
+		// initialize sentinel page
+		PUGI_IMPL_STATIC_ASSERT(sizeof(impl::xml_memory_page) + sizeof(impl::xml_document_struct) + page_offset <= sizeof(_memory));
+
+		// prepare page structure
+		impl::xml_memory_page* page = impl::xml_memory_page::construct(_memory);
+		assert(page);
+
+		page->busy_size = impl::xml_memory_page_size;
+
+		// setup first page marker
+	#ifdef PUGIXML_COMPACT
+		// round-trip through void* to avoid 'cast increases required alignment of target type' warning
+		page->compact_page_marker = reinterpret_cast<uint32_t*>(static_cast<void*>(reinterpret_cast<char*>(page) + sizeof(impl::xml_memory_page)));
+		*page->compact_page_marker = sizeof(impl::xml_memory_page);
+	#endif
+
+		// allocate new root
+		_root = new (reinterpret_cast<char*>(page) + sizeof(impl::xml_memory_page) + page_offset) impl::xml_document_struct(page);
+		_root->prev_sibling_c = _root;
+
+		// setup sentinel page
+		page->allocator = static_cast<impl::xml_document_struct*>(_root);
+
+		// setup hash table pointer in allocator
+	#ifdef PUGIXML_COMPACT
+		page->allocator->_hash = &static_cast<impl::xml_document_struct*>(_root)->hash;
+	#endif
+
+		// verify the document allocation
+		assert(reinterpret_cast<char*>(_root) + sizeof(impl::xml_document_struct) <= _memory + sizeof(_memory));
+	}
+
+	PUGI_IMPL_FN void xml_document::_destroy()
+	{
+		assert(_root);
+
+		// destroy static storage
+		if (_buffer)
+		{
+			impl::xml_memory::deallocate(_buffer);
+			_buffer = 0;
+		}
+
+		// destroy extra buffers (note: no need to destroy linked list nodes, they're allocated using document allocator)
+		for (impl::xml_extra_buffer* extra = static_cast<impl::xml_document_struct*>(_root)->extra_buffers; extra; extra = extra->next)
+		{
+			if (extra->buffer) impl::xml_memory::deallocate(extra->buffer);
+		}
+
+		// destroy dynamic storage, leave sentinel page (it's in static memory)
+		impl::xml_memory_page* root_page = PUGI_IMPL_GETPAGE(_root);
+		assert(root_page && !root_page->prev);
+		assert(reinterpret_cast<char*>(root_page) >= _memory && reinterpret_cast<char*>(root_page) < _memory + sizeof(_memory));
+
+		for (impl::xml_memory_page* page = root_page->next; page; )
+		{
+			impl::xml_memory_page* next = page->next;
+
+			impl::xml_allocator::deallocate_page(page);
+
+			page = next;
+		}
+
+	#ifdef PUGIXML_COMPACT
+		// destroy hash table
+		static_cast<impl::xml_document_struct*>(_root)->hash.clear();
+	#endif
+
+		_root = 0;
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN void xml_document::_move(xml_document& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT
+	{
+		impl::xml_document_struct* doc = static_cast<impl::xml_document_struct*>(_root);
+		impl::xml_document_struct* other = static_cast<impl::xml_document_struct*>(rhs._root);
+
+		// save first child pointer for later; this needs hash access
+		xml_node_struct* other_first_child = other->first_child;
+
+	#ifdef PUGIXML_COMPACT
+		// reserve space for the hash table up front; this is the only operation that can fail
+		// if it does, we have no choice but to throw (if we have exceptions)
+		if (other_first_child)
+		{
+			size_t other_children = 0;
+			for (xml_node_struct* node = other_first_child; node; node = node->next_sibling)
+				other_children++;
+
+			// in compact mode, each pointer assignment could result in a hash table request
+			// during move, we have to relocate document first_child and parents of all children
+			// normally there's just one child and its parent has a pointerless encoding but
+			// we assume the worst here
+			if (!other->_hash->reserve(other_children + 1))
+			{
+			#ifdef PUGIXML_NO_EXCEPTIONS
+				return;
+			#else
+				throw std::bad_alloc();
+			#endif
+			}
+		}
+	#endif
+
+		// move allocation state
+		// note that other->_root may point to the embedded document page, in which case we should keep original (empty) state
+		if (other->_root != PUGI_IMPL_GETPAGE(other))
+		{
+			doc->_root = other->_root;
+			doc->_busy_size = other->_busy_size;
+		}
+
+		// move buffer state
+		doc->buffer = other->buffer;
+		doc->extra_buffers = other->extra_buffers;
+		_buffer = rhs._buffer;
+
+	#ifdef PUGIXML_COMPACT
+		// move compact hash; note that the hash table can have pointers to other but they will be "inactive", similarly to nodes removed with remove_child
+		doc->hash = other->hash;
+		doc->_hash = &doc->hash;
+
+		// make sure we don't access other hash up until the end when we reinitialize other document
+		other->_hash = 0;
+	#endif
+
+		// move page structure
+		impl::xml_memory_page* doc_page = PUGI_IMPL_GETPAGE(doc);
+		assert(doc_page && !doc_page->prev && !doc_page->next);
+
+		impl::xml_memory_page* other_page = PUGI_IMPL_GETPAGE(other);
+		assert(other_page && !other_page->prev);
+
+		// relink pages since root page is embedded into xml_document
+		if (impl::xml_memory_page* page = other_page->next)
+		{
+			assert(page->prev == other_page);
+
+			page->prev = doc_page;
+
+			doc_page->next = page;
+			other_page->next = 0;
+		}
+
+		// make sure pages point to the correct document state
+		for (impl::xml_memory_page* page = doc_page->next; page; page = page->next)
+		{
+			assert(page->allocator == other);
+
+			page->allocator = doc;
+
+		#ifdef PUGIXML_COMPACT
+			// this automatically migrates most children between documents and prevents ->parent assignment from allocating
+			if (page->compact_shared_parent == other)
+				page->compact_shared_parent = doc;
+		#endif
+		}
+
+		// move tree structure
+		assert(!doc->first_child);
+
+		doc->first_child = other_first_child;
+
+		for (xml_node_struct* node = other_first_child; node; node = node->next_sibling)
+		{
+		#ifdef PUGIXML_COMPACT
+			// most children will have migrated when we reassigned compact_shared_parent
+			assert(node->parent == other || node->parent == doc);
+
+			node->parent = doc;
+		#else
+			assert(node->parent == other);
+			node->parent = doc;
+		#endif
+		}
+
+		// reset other document
+		new (other) impl::xml_document_struct(PUGI_IMPL_GETPAGE(other));
+		rhs._buffer = 0;
+	}
+#endif
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN xml_parse_result xml_document::load(std::basic_istream<char, std::char_traits<char> >& stream, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		return impl::load_stream_impl(static_cast<impl::xml_document_struct*>(_root), stream, options, encoding, &_buffer);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load(std::basic_istream<wchar_t, std::char_traits<wchar_t> >& stream, unsigned int options)
+	{
+		reset();
+
+		return impl::load_stream_impl(static_cast<impl::xml_document_struct*>(_root), stream, options, encoding_wchar, &_buffer);
+	}
+#endif
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_string(const char_t* contents, unsigned int options)
+	{
+		// Force native encoding (skip autodetection)
+	#ifdef PUGIXML_WCHAR_MODE
+		xml_encoding encoding = encoding_wchar;
+	#else
+		xml_encoding encoding = encoding_utf8;
+	#endif
+
+		return load_buffer(contents, impl::strlength(contents) * sizeof(char_t), options, encoding);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load(const char_t* contents, unsigned int options)
+	{
+		return load_string(contents, options);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_file(const char* path_, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		using impl::auto_deleter; // MSVC7 workaround
+		auto_deleter<FILE> file(impl::open_file(path_, "rb"), impl::close_file);
+
+		return impl::load_file_impl(static_cast<impl::xml_document_struct*>(_root), file.data, options, encoding, &_buffer);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_file(const wchar_t* path_, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		using impl::auto_deleter; // MSVC7 workaround
+		auto_deleter<FILE> file(impl::open_file_wide(path_, L"rb"), impl::close_file);
+
+		return impl::load_file_impl(static_cast<impl::xml_document_struct*>(_root), file.data, options, encoding, &_buffer);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_buffer(const void* contents, size_t size, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		return impl::load_buffer_impl(static_cast<impl::xml_document_struct*>(_root), _root, const_cast<void*>(contents), size, options, encoding, false, false, &_buffer);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_buffer_inplace(void* contents, size_t size, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		return impl::load_buffer_impl(static_cast<impl::xml_document_struct*>(_root), _root, contents, size, options, encoding, true, false, &_buffer);
+	}
+
+	PUGI_IMPL_FN xml_parse_result xml_document::load_buffer_inplace_own(void* contents, size_t size, unsigned int options, xml_encoding encoding)
+	{
+		reset();
+
+		return impl::load_buffer_impl(static_cast<impl::xml_document_struct*>(_root), _root, contents, size, options, encoding, true, true, &_buffer);
+	}
+
+	PUGI_IMPL_FN void xml_document::save(xml_writer& writer, const char_t* indent, unsigned int flags, xml_encoding encoding) const
+	{
+		impl::xml_buffered_writer buffered_writer(writer, encoding);
+
+		if ((flags & format_write_bom) && encoding != encoding_latin1)
+		{
+			// BOM always represents the codepoint U+FEFF, so just write it in native encoding
+		#ifdef PUGIXML_WCHAR_MODE
+			unsigned int bom = 0xfeff;
+			buffered_writer.write(static_cast<wchar_t>(bom));
+		#else
+			buffered_writer.write('\xef', '\xbb', '\xbf');
+		#endif
+		}
+
+		if (!(flags & format_no_declaration) && !impl::has_declaration(_root))
+		{
+			buffered_writer.write_string(PUGIXML_TEXT("<?xml version=\"1.0\""));
+			if (encoding == encoding_latin1) buffered_writer.write_string(PUGIXML_TEXT(" encoding=\"ISO-8859-1\""));
+			buffered_writer.write('?', '>');
+			if (!(flags & format_raw)) buffered_writer.write('\n');
+		}
+
+		impl::node_output(buffered_writer, _root, indent, flags, 0);
+
+		buffered_writer.flush();
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN void xml_document::save(std::basic_ostream<char, std::char_traits<char> >& stream, const char_t* indent, unsigned int flags, xml_encoding encoding) const
+	{
+		xml_writer_stream writer(stream);
+
+		save(writer, indent, flags, encoding);
+	}
+
+	PUGI_IMPL_FN void xml_document::save(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& stream, const char_t* indent, unsigned int flags) const
+	{
+		xml_writer_stream writer(stream);
+
+		save(writer, indent, flags, encoding_wchar);
+	}
+#endif
+
+	PUGI_IMPL_FN bool xml_document::save_file(const char* path_, const char_t* indent, unsigned int flags, xml_encoding encoding) const
+	{
+		using impl::auto_deleter; // MSVC7 workaround
+		auto_deleter<FILE> file(impl::open_file(path_, (flags & format_save_file_text) ? "w" : "wb"), impl::close_file);
+
+		return impl::save_file_impl(*this, file.data, indent, flags, encoding) && fclose(file.release()) == 0;
+	}
+
+	PUGI_IMPL_FN bool xml_document::save_file(const wchar_t* path_, const char_t* indent, unsigned int flags, xml_encoding encoding) const
+	{
+		using impl::auto_deleter; // MSVC7 workaround
+		auto_deleter<FILE> file(impl::open_file_wide(path_, (flags & format_save_file_text) ? L"w" : L"wb"), impl::close_file);
+
+		return impl::save_file_impl(*this, file.data, indent, flags, encoding) && fclose(file.release()) == 0;
+	}
+
+	PUGI_IMPL_FN xml_node xml_document::document_element() const
+	{
+		assert(_root);
+
+		for (xml_node_struct* i = _root->first_child; i; i = i->next_sibling)
+			if (PUGI_IMPL_NODETYPE(i) == node_element)
+				return xml_node(i);
+
+		return xml_node();
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN std::string PUGIXML_FUNCTION as_utf8(const wchar_t* str)
+	{
+		assert(str);
+
+		return impl::as_utf8_impl(str, impl::strlength_wide(str));
+	}
+
+	PUGI_IMPL_FN std::string PUGIXML_FUNCTION as_utf8(const std::basic_string<wchar_t>& str)
+	{
+		return impl::as_utf8_impl(str.c_str(), str.size());
+	}
+
+	PUGI_IMPL_FN std::basic_string<wchar_t> PUGIXML_FUNCTION as_wide(const char* str)
+	{
+		assert(str);
+
+		return impl::as_wide_impl(str, strlen(str));
+	}
+
+	PUGI_IMPL_FN std::basic_string<wchar_t> PUGIXML_FUNCTION as_wide(const std::string& str)
+	{
+		return impl::as_wide_impl(str.c_str(), str.size());
+	}
+#endif
+
+	PUGI_IMPL_FN void PUGIXML_FUNCTION set_memory_management_functions(allocation_function allocate, deallocation_function deallocate)
+	{
+		impl::xml_memory::allocate = allocate;
+		impl::xml_memory::deallocate = deallocate;
+	}
+
+	PUGI_IMPL_FN allocation_function PUGIXML_FUNCTION get_memory_allocation_function()
+	{
+		return impl::xml_memory::allocate;
+	}
+
+	PUGI_IMPL_FN deallocation_function PUGIXML_FUNCTION get_memory_deallocation_function()
+	{
+		return impl::xml_memory::deallocate;
+	}
+}
+
+#if !defined(PUGIXML_NO_STL) && (defined(_MSC_VER) || defined(__ICC))
+namespace std
+{
+	// Workarounds for (non-standard) iterator category detection for older versions (MSVC7/IC8 and earlier)
+	PUGI_IMPL_FN std::bidirectional_iterator_tag _Iter_cat(const pugi::xml_node_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+
+	PUGI_IMPL_FN std::bidirectional_iterator_tag _Iter_cat(const pugi::xml_attribute_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+
+	PUGI_IMPL_FN std::bidirectional_iterator_tag _Iter_cat(const pugi::xml_named_node_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+}
+#endif
+
+#if !defined(PUGIXML_NO_STL) && defined(__SUNPRO_CC)
+namespace std
+{
+	// Workarounds for (non-standard) iterator category detection
+	PUGI_IMPL_FN std::bidirectional_iterator_tag __iterator_category(const pugi::xml_node_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+
+	PUGI_IMPL_FN std::bidirectional_iterator_tag __iterator_category(const pugi::xml_attribute_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+
+	PUGI_IMPL_FN std::bidirectional_iterator_tag __iterator_category(const pugi::xml_named_node_iterator&)
+	{
+		return std::bidirectional_iterator_tag();
+	}
+}
+#endif
+
+#ifndef PUGIXML_NO_XPATH
+// STL replacements
+PUGI_IMPL_NS_BEGIN
+	struct equal_to
+	{
+		template <typename T> bool operator()(const T& lhs, const T& rhs) const
+		{
+			return lhs == rhs;
+		}
+	};
+
+	struct not_equal_to
+	{
+		template <typename T> bool operator()(const T& lhs, const T& rhs) const
+		{
+			return lhs != rhs;
+		}
+	};
+
+	struct less
+	{
+		template <typename T> bool operator()(const T& lhs, const T& rhs) const
+		{
+			return lhs < rhs;
+		}
+	};
+
+	struct less_equal
+	{
+		template <typename T> bool operator()(const T& lhs, const T& rhs) const
+		{
+			return lhs <= rhs;
+		}
+	};
+
+	template <typename T> inline void swap(T& lhs, T& rhs)
+	{
+		T temp = lhs;
+		lhs = rhs;
+		rhs = temp;
+	}
+
+	template <typename I, typename Pred> PUGI_IMPL_FN I min_element(I begin, I end, const Pred& pred)
+	{
+		I result = begin;
+
+		for (I it = begin + 1; it != end; ++it)
+			if (pred(*it, *result))
+				result = it;
+
+		return result;
+	}
+
+	template <typename I> PUGI_IMPL_FN void reverse(I begin, I end)
+	{
+		while (end - begin > 1)
+			swap(*begin++, *--end);
+	}
+
+	template <typename I> PUGI_IMPL_FN I unique(I begin, I end)
+	{
+		// fast skip head
+		while (end - begin > 1 && *begin != *(begin + 1))
+			begin++;
+
+		if (begin == end)
+			return begin;
+
+		// last written element
+		I write = begin++;
+
+		// merge unique elements
+		while (begin != end)
+		{
+			if (*begin != *write)
+				*++write = *begin++;
+			else
+				begin++;
+		}
+
+		// past-the-end (write points to live element)
+		return write + 1;
+	}
+
+	template <typename T, typename Pred> PUGI_IMPL_FN void insertion_sort(T* begin, T* end, const Pred& pred)
+	{
+		if (begin == end)
+			return;
+
+		for (T* it = begin + 1; it != end; ++it)
+		{
+			T val = *it;
+			T* hole = it;
+
+			// move hole backwards
+			while (hole > begin && pred(val, *(hole - 1)))
+			{
+				*hole = *(hole - 1);
+				hole--;
+			}
+
+			// fill hole with element
+			*hole = val;
+		}
+	}
+
+	template <typename I, typename Pred> inline I median3(I first, I middle, I last, const Pred& pred)
+	{
+		if (pred(*middle, *first))
+			swap(middle, first);
+		if (pred(*last, *middle))
+			swap(last, middle);
+		if (pred(*middle, *first))
+			swap(middle, first);
+
+		return middle;
+	}
+
+	template <typename T, typename Pred> PUGI_IMPL_FN void partition3(T* begin, T* end, T pivot, const Pred& pred, T** out_eqbeg, T** out_eqend)
+	{
+		// invariant: array is split into 4 groups: = < ? > (each variable denotes the boundary between the groups)
+		T* eq = begin;
+		T* lt = begin;
+		T* gt = end;
+
+		while (lt < gt)
+		{
+			if (pred(*lt, pivot))
+				lt++;
+			else if (*lt == pivot)
+				swap(*eq++, *lt++);
+			else
+				swap(*lt, *--gt);
+		}
+
+		// we now have just 4 groups: = < >; move equal elements to the middle
+		T* eqbeg = gt;
+
+		for (T* it = begin; it != eq; ++it)
+			swap(*it, *--eqbeg);
+
+		*out_eqbeg = eqbeg;
+		*out_eqend = gt;
+	}
+
+	template <typename I, typename Pred> PUGI_IMPL_FN void sort(I begin, I end, const Pred& pred)
+	{
+		// sort large chunks
+		while (end - begin > 16)
+		{
+			// find median element
+			I middle = begin + (end - begin) / 2;
+			I median = median3(begin, middle, end - 1, pred);
+
+			// partition in three chunks (< = >)
+			I eqbeg, eqend;
+			partition3(begin, end, *median, pred, &eqbeg, &eqend);
+
+			// loop on larger half
+			if (eqbeg - begin > end - eqend)
+			{
+				sort(eqend, end, pred);
+				end = eqbeg;
+			}
+			else
+			{
+				sort(begin, eqbeg, pred);
+				begin = eqend;
+			}
+		}
+
+		// insertion sort small chunk
+		insertion_sort(begin, end, pred);
+	}
+
+	PUGI_IMPL_FN bool hash_insert(const void** table, size_t size, const void* key)
+	{
+		assert(key);
+
+		unsigned int h = static_cast<unsigned int>(reinterpret_cast<uintptr_t>(key));
+
+		// MurmurHash3 32-bit finalizer
+		h ^= h >> 16;
+		h *= 0x85ebca6bu;
+		h ^= h >> 13;
+		h *= 0xc2b2ae35u;
+		h ^= h >> 16;
+
+		size_t hashmod = size - 1;
+		size_t bucket = h & hashmod;
+
+		for (size_t probe = 0; probe <= hashmod; ++probe)
+		{
+			if (table[bucket] == 0)
+			{
+				table[bucket] = key;
+				return true;
+			}
+
+			if (table[bucket] == key)
+				return false;
+
+			// hash collision, quadratic probing
+			bucket = (bucket + probe + 1) & hashmod;
+		}
+
+		assert(false && "Hash table is full"); // unreachable
+		return false;
+	}
+PUGI_IMPL_NS_END
+
+// Allocator used for AST and evaluation stacks
+PUGI_IMPL_NS_BEGIN
+	static const size_t xpath_memory_page_size =
+	#ifdef PUGIXML_MEMORY_XPATH_PAGE_SIZE
+		PUGIXML_MEMORY_XPATH_PAGE_SIZE
+	#else
+		4096
+	#endif
+		;
+
+	static const uintptr_t xpath_memory_block_alignment = sizeof(double) > sizeof(void*) ? sizeof(double) : sizeof(void*);
+
+	struct xpath_memory_block
+	{
+		xpath_memory_block* next;
+		size_t capacity;
+
+		union
+		{
+			char data[xpath_memory_page_size];
+			double alignment;
+		};
+	};
+
+	struct xpath_allocator
+	{
+		xpath_memory_block* _root;
+		size_t _root_size;
+		bool* _error;
+
+		xpath_allocator(xpath_memory_block* root, bool* error = 0): _root(root), _root_size(0), _error(error)
+		{
+		}
+
+		void* allocate(size_t size)
+		{
+			// round size up to block alignment boundary
+			size = (size + xpath_memory_block_alignment - 1) & ~(xpath_memory_block_alignment - 1);
+
+			if (_root_size + size <= _root->capacity)
+			{
+				void* buf = &_root->data[0] + _root_size;
+				_root_size += size;
+				return buf;
+			}
+			else
+			{
+				// make sure we have at least 1/4th of the page free after allocation to satisfy subsequent allocation requests
+				size_t block_capacity_base = sizeof(_root->data);
+				size_t block_capacity_req = size + block_capacity_base / 4;
+				size_t block_capacity = (block_capacity_base > block_capacity_req) ? block_capacity_base : block_capacity_req;
+
+				size_t block_size = block_capacity + offsetof(xpath_memory_block, data);
+
+				xpath_memory_block* block = static_cast<xpath_memory_block*>(xml_memory::allocate(block_size));
+				if (!block)
+				{
+					if (_error) *_error = true;
+					return 0;
+				}
+
+				block->next = _root;
+				block->capacity = block_capacity;
+
+				_root = block;
+				_root_size = size;
+
+				return block->data;
+			}
+		}
+
+		void* reallocate(void* ptr, size_t old_size, size_t new_size)
+		{
+			// round size up to block alignment boundary
+			old_size = (old_size + xpath_memory_block_alignment - 1) & ~(xpath_memory_block_alignment - 1);
+			new_size = (new_size + xpath_memory_block_alignment - 1) & ~(xpath_memory_block_alignment - 1);
+
+			// we can only reallocate the last object
+			assert(ptr == 0 || static_cast<char*>(ptr) + old_size == &_root->data[0] + _root_size);
+
+			// try to reallocate the object inplace
+			if (ptr && _root_size - old_size + new_size <= _root->capacity)
+			{
+				_root_size = _root_size - old_size + new_size;
+				return ptr;
+			}
+
+			// allocate a new block
+			void* result = allocate(new_size);
+			if (!result) return 0;
+
+			// we have a new block
+			if (ptr)
+			{
+				// copy old data (we only support growing)
+				assert(new_size >= old_size);
+				memcpy(result, ptr, old_size);
+
+				// free the previous page if it had no other objects
+				assert(_root->data == result);
+				assert(_root->next);
+
+				if (_root->next->data == ptr)
+				{
+					// deallocate the whole page, unless it was the first one
+					xpath_memory_block* next = _root->next->next;
+
+					if (next)
+					{
+						xml_memory::deallocate(_root->next);
+						_root->next = next;
+					}
+				}
+			}
+
+			return result;
+		}
+
+		void revert(const xpath_allocator& state)
+		{
+			// free all new pages
+			xpath_memory_block* cur = _root;
+
+			while (cur != state._root)
+			{
+				xpath_memory_block* next = cur->next;
+
+				xml_memory::deallocate(cur);
+
+				cur = next;
+			}
+
+			// restore state
+			_root = state._root;
+			_root_size = state._root_size;
+		}
+
+		void release()
+		{
+			xpath_memory_block* cur = _root;
+			assert(cur);
+
+			while (cur->next)
+			{
+				xpath_memory_block* next = cur->next;
+
+				xml_memory::deallocate(cur);
+
+				cur = next;
+			}
+		}
+	};
+
+	struct xpath_allocator_capture
+	{
+		xpath_allocator_capture(xpath_allocator* alloc): _target(alloc), _state(*alloc)
+		{
+		}
+
+		~xpath_allocator_capture()
+		{
+			_target->revert(_state);
+		}
+
+		xpath_allocator* _target;
+		xpath_allocator _state;
+	};
+
+	struct xpath_stack
+	{
+		xpath_allocator* result;
+		xpath_allocator* temp;
+	};
+
+	struct xpath_stack_data
+	{
+		xpath_memory_block blocks[2];
+		xpath_allocator result;
+		xpath_allocator temp;
+		xpath_stack stack;
+		bool oom;
+
+		xpath_stack_data(): result(blocks + 0, &oom), temp(blocks + 1, &oom), oom(false)
+		{
+			blocks[0].next = blocks[1].next = 0;
+			blocks[0].capacity = blocks[1].capacity = sizeof(blocks[0].data);
+
+			stack.result = &result;
+			stack.temp = &temp;
+		}
+
+		~xpath_stack_data()
+		{
+			result.release();
+			temp.release();
+		}
+	};
+PUGI_IMPL_NS_END
+
+// String class
+PUGI_IMPL_NS_BEGIN
+	class xpath_string
+	{
+		const char_t* _buffer;
+		bool _uses_heap;
+		size_t _length_heap;
+
+		static char_t* duplicate_string(const char_t* string, size_t length, xpath_allocator* alloc)
+		{
+			char_t* result = static_cast<char_t*>(alloc->allocate((length + 1) * sizeof(char_t)));
+			if (!result) return 0;
+
+			memcpy(result, string, length * sizeof(char_t));
+			result[length] = 0;
+
+			return result;
+		}
+
+		xpath_string(const char_t* buffer, bool uses_heap_, size_t length_heap): _buffer(buffer), _uses_heap(uses_heap_), _length_heap(length_heap)
+		{
+		}
+
+	public:
+		static xpath_string from_const(const char_t* str)
+		{
+			return xpath_string(str, false, 0);
+		}
+
+		static xpath_string from_heap_preallocated(const char_t* begin, const char_t* end)
+		{
+			assert(begin <= end && *end == 0);
+
+			return xpath_string(begin, true, static_cast<size_t>(end - begin));
+		}
+
+		static xpath_string from_heap(const char_t* begin, const char_t* end, xpath_allocator* alloc)
+		{
+			assert(begin <= end);
+
+			if (begin == end)
+				return xpath_string();
+
+			size_t length = static_cast<size_t>(end - begin);
+			const char_t* data = duplicate_string(begin, length, alloc);
+
+			return data ? xpath_string(data, true, length) : xpath_string();
+		}
+
+		xpath_string(): _buffer(PUGIXML_TEXT("")), _uses_heap(false), _length_heap(0)
+		{
+		}
+
+		void append(const xpath_string& o, xpath_allocator* alloc)
+		{
+			// skip empty sources
+			if (!*o._buffer) return;
+
+			// fast append for constant empty target and constant source
+			if (!*_buffer && !_uses_heap && !o._uses_heap)
+			{
+				_buffer = o._buffer;
+			}
+			else
+			{
+				// need to make heap copy
+				size_t target_length = length();
+				size_t source_length = o.length();
+				size_t result_length = target_length + source_length;
+
+				// allocate new buffer
+				char_t* result = static_cast<char_t*>(alloc->reallocate(_uses_heap ? const_cast<char_t*>(_buffer) : 0, (target_length + 1) * sizeof(char_t), (result_length + 1) * sizeof(char_t)));
+				if (!result) return;
+
+				// append first string to the new buffer in case there was no reallocation
+				if (!_uses_heap) memcpy(result, _buffer, target_length * sizeof(char_t));
+
+				// append second string to the new buffer
+				memcpy(result + target_length, o._buffer, source_length * sizeof(char_t));
+				result[result_length] = 0;
+
+				// finalize
+				_buffer = result;
+				_uses_heap = true;
+				_length_heap = result_length;
+			}
+		}
+
+		const char_t* c_str() const
+		{
+			return _buffer;
+		}
+
+		size_t length() const
+		{
+			return _uses_heap ? _length_heap : strlength(_buffer);
+		}
+
+		char_t* data(xpath_allocator* alloc)
+		{
+			// make private heap copy
+			if (!_uses_heap)
+			{
+				size_t length_ = strlength(_buffer);
+				const char_t* data_ = duplicate_string(_buffer, length_, alloc);
+
+				if (!data_) return 0;
+
+				_buffer = data_;
+				_uses_heap = true;
+				_length_heap = length_;
+			}
+
+			return const_cast<char_t*>(_buffer);
+		}
+
+		bool empty() const
+		{
+			return *_buffer == 0;
+		}
+
+		bool operator==(const xpath_string& o) const
+		{
+			return strequal(_buffer, o._buffer);
+		}
+
+		bool operator!=(const xpath_string& o) const
+		{
+			return !strequal(_buffer, o._buffer);
+		}
+
+		bool uses_heap() const
+		{
+			return _uses_heap;
+		}
+	};
+PUGI_IMPL_NS_END
+
+PUGI_IMPL_NS_BEGIN
+	PUGI_IMPL_FN bool starts_with(const char_t* string, const char_t* pattern)
+	{
+		while (*pattern && *string == *pattern)
+		{
+			string++;
+			pattern++;
+		}
+
+		return *pattern == 0;
+	}
+
+	PUGI_IMPL_FN const char_t* find_char(const char_t* s, char_t c)
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcschr(s, c);
+	#else
+		return strchr(s, c);
+	#endif
+	}
+
+	PUGI_IMPL_FN const char_t* find_substring(const char_t* s, const char_t* p)
+	{
+	#ifdef PUGIXML_WCHAR_MODE
+		// MSVC6 wcsstr bug workaround (if s is empty it always returns 0)
+		return (*p == 0) ? s : wcsstr(s, p);
+	#else
+		return strstr(s, p);
+	#endif
+	}
+
+	// Converts symbol to lower case, if it is an ASCII one
+	PUGI_IMPL_FN char_t tolower_ascii(char_t ch)
+	{
+		return static_cast<unsigned int>(ch - 'A') < 26 ? static_cast<char_t>(ch | ' ') : ch;
+	}
+
+	PUGI_IMPL_FN xpath_string string_value(const xpath_node& na, xpath_allocator* alloc)
+	{
+		if (na.attribute())
+			return xpath_string::from_const(na.attribute().value());
+		else
+		{
+			xml_node n = na.node();
+
+			switch (n.type())
+			{
+			case node_pcdata:
+			case node_cdata:
+			case node_comment:
+			case node_pi:
+				return xpath_string::from_const(n.value());
+
+			case node_document:
+			case node_element:
+			{
+				xpath_string result;
+
+				// element nodes can have value if parse_embed_pcdata was used
+				if (n.value()[0])
+					result.append(xpath_string::from_const(n.value()), alloc);
+
+				xml_node cur = n.first_child();
+
+				while (cur && cur != n)
+				{
+					if (cur.type() == node_pcdata || cur.type() == node_cdata)
+						result.append(xpath_string::from_const(cur.value()), alloc);
+
+					if (cur.first_child())
+						cur = cur.first_child();
+					else if (cur.next_sibling())
+						cur = cur.next_sibling();
+					else
+					{
+						while (!cur.next_sibling() && cur != n)
+							cur = cur.parent();
+
+						if (cur != n) cur = cur.next_sibling();
+					}
+				}
+
+				return result;
+			}
+
+			default:
+				return xpath_string();
+			}
+		}
+	}
+
+	PUGI_IMPL_FN bool node_is_before_sibling(xml_node_struct* ln, xml_node_struct* rn)
+	{
+		assert(ln->parent == rn->parent);
+
+		// there is no common ancestor (the shared parent is null), nodes are from different documents
+		if (!ln->parent) return ln < rn;
+
+		// determine sibling order
+		xml_node_struct* ls = ln;
+		xml_node_struct* rs = rn;
+
+		while (ls && rs)
+		{
+			if (ls == rn) return true;
+			if (rs == ln) return false;
+
+			ls = ls->next_sibling;
+			rs = rs->next_sibling;
+		}
+
+		// if rn sibling chain ended ln must be before rn
+		return !rs;
+	}
+
+	PUGI_IMPL_FN bool node_is_before(xml_node_struct* ln, xml_node_struct* rn)
+	{
+		// find common ancestor at the same depth, if any
+		xml_node_struct* lp = ln;
+		xml_node_struct* rp = rn;
+
+		while (lp && rp && lp->parent != rp->parent)
+		{
+			lp = lp->parent;
+			rp = rp->parent;
+		}
+
+		// parents are the same!
+		if (lp && rp) return node_is_before_sibling(lp, rp);
+
+		// nodes are at different depths, need to normalize heights
+		bool left_higher = !lp;
+
+		while (lp)
+		{
+			lp = lp->parent;
+			ln = ln->parent;
+		}
+
+		while (rp)
+		{
+			rp = rp->parent;
+			rn = rn->parent;
+		}
+
+		// one node is the ancestor of the other
+		if (ln == rn) return left_higher;
+
+		// find common ancestor... again
+		while (ln->parent != rn->parent)
+		{
+			ln = ln->parent;
+			rn = rn->parent;
+		}
+
+		return node_is_before_sibling(ln, rn);
+	}
+
+	PUGI_IMPL_FN bool node_is_ancestor(xml_node_struct* parent, xml_node_struct* node)
+	{
+		while (node && node != parent) node = node->parent;
+
+		return parent && node == parent;
+	}
+
+	PUGI_IMPL_FN const void* document_buffer_order(const xpath_node& xnode)
+	{
+		xml_node_struct* node = xnode.node().internal_object();
+
+		if (node)
+		{
+			if ((get_document(node).header & xml_memory_page_contents_shared_mask) == 0)
+			{
+				if (node->name && (node->header & impl::xml_memory_page_name_allocated_or_shared_mask) == 0) return node->name;
+				if (node->value && (node->header & impl::xml_memory_page_value_allocated_or_shared_mask) == 0) return node->value;
+			}
+
+			return 0;
+		}
+
+		xml_attribute_struct* attr = xnode.attribute().internal_object();
+
+		if (attr)
+		{
+			if ((get_document(attr).header & xml_memory_page_contents_shared_mask) == 0)
+			{
+				if ((attr->header & impl::xml_memory_page_name_allocated_or_shared_mask) == 0) return attr->name;
+				if ((attr->header & impl::xml_memory_page_value_allocated_or_shared_mask) == 0) return attr->value;
+			}
+
+			return 0;
+		}
+
+		return 0;
+	}
+
+	struct document_order_comparator
+	{
+		bool operator()(const xpath_node& lhs, const xpath_node& rhs) const
+		{
+			// optimized document order based check
+			const void* lo = document_buffer_order(lhs);
+			const void* ro = document_buffer_order(rhs);
+
+			if (lo && ro) return lo < ro;
+
+			// slow comparison
+			xml_node ln = lhs.node(), rn = rhs.node();
+
+			// compare attributes
+			if (lhs.attribute() && rhs.attribute())
+			{
+				// shared parent
+				if (lhs.parent() == rhs.parent())
+				{
+					// determine sibling order
+					for (xml_attribute a = lhs.attribute(); a; a = a.next_attribute())
+						if (a == rhs.attribute())
+							return true;
+
+					return false;
+				}
+
+				// compare attribute parents
+				ln = lhs.parent();
+				rn = rhs.parent();
+			}
+			else if (lhs.attribute())
+			{
+				// attributes go after the parent element
+				if (lhs.parent() == rhs.node()) return false;
+
+				ln = lhs.parent();
+			}
+			else if (rhs.attribute())
+			{
+				// attributes go after the parent element
+				if (rhs.parent() == lhs.node()) return true;
+
+				rn = rhs.parent();
+			}
+
+			if (ln == rn) return false;
+
+			if (!ln || !rn) return ln < rn;
+
+			return node_is_before(ln.internal_object(), rn.internal_object());
+		}
+	};
+
+	PUGI_IMPL_FN double gen_nan()
+	{
+	#if defined(__STDC_IEC_559__) || ((FLT_RADIX - 0 == 2) && (FLT_MAX_EXP - 0 == 128) && (FLT_MANT_DIG - 0 == 24))
+		PUGI_IMPL_STATIC_ASSERT(sizeof(float) == sizeof(uint32_t));
+		typedef uint32_t UI; // BCC5 workaround
+		union { float f; UI i; } u;
+		u.i = 0x7fc00000;
+		return double(u.f);
+	#else
+		// fallback
+		const volatile double zero = 0.0;
+		return zero / zero;
+	#endif
+	}
+
+	PUGI_IMPL_FN bool is_nan(double value)
+	{
+	#if defined(PUGI_IMPL_MSVC_CRT_VERSION) || defined(__BORLANDC__)
+		return !!_isnan(value);
+	#elif defined(fpclassify) && defined(FP_NAN)
+		return fpclassify(value) == FP_NAN;
+	#else
+		// fallback
+		const volatile double v = value;
+		return v != v;
+	#endif
+	}
+
+	PUGI_IMPL_FN const char_t* convert_number_to_string_special(double value)
+	{
+	#if defined(PUGI_IMPL_MSVC_CRT_VERSION) || defined(__BORLANDC__)
+		if (_finite(value)) return (value == 0) ? PUGIXML_TEXT("0") : 0;
+		if (_isnan(value)) return PUGIXML_TEXT("NaN");
+		return value > 0 ? PUGIXML_TEXT("Infinity") : PUGIXML_TEXT("-Infinity");
+	#elif defined(fpclassify) && defined(FP_NAN) && defined(FP_INFINITE) && defined(FP_ZERO)
+		switch (fpclassify(value))
+		{
+		case FP_NAN:
+			return PUGIXML_TEXT("NaN");
+
+		case FP_INFINITE:
+			return value > 0 ? PUGIXML_TEXT("Infinity") : PUGIXML_TEXT("-Infinity");
+
+		case FP_ZERO:
+			return PUGIXML_TEXT("0");
+
+		default:
+			return 0;
+		}
+	#else
+		// fallback
+		const volatile double v = value;
+
+		if (v == 0) return PUGIXML_TEXT("0");
+		if (v != v) return PUGIXML_TEXT("NaN");
+		if (v * 2 == v) return value > 0 ? PUGIXML_TEXT("Infinity") : PUGIXML_TEXT("-Infinity");
+		return 0;
+	#endif
+	}
+
+	PUGI_IMPL_FN bool convert_number_to_boolean(double value)
+	{
+		return (value != 0 && !is_nan(value));
+	}
+
+	PUGI_IMPL_FN void truncate_zeros(char* begin, char* end)
+	{
+		while (begin != end && end[-1] == '0') end--;
+
+		*end = 0;
+	}
+
+	// gets mantissa digits in the form of 0.xxxxx with 0. implied and the exponent
+#if defined(PUGI_IMPL_MSVC_CRT_VERSION) && PUGI_IMPL_MSVC_CRT_VERSION >= 1400
+	PUGI_IMPL_FN void convert_number_to_mantissa_exponent(double value, char (&buffer)[32], char** out_mantissa, int* out_exponent)
+	{
+		// get base values
+		int sign, exponent;
+		_ecvt_s(buffer, sizeof(buffer), value, DBL_DIG + 1, &exponent, &sign);
+
+		// truncate redundant zeros
+		truncate_zeros(buffer, buffer + strlen(buffer));
+
+		// fill results
+		*out_mantissa = buffer;
+		*out_exponent = exponent;
+	}
+#else
+	PUGI_IMPL_FN void convert_number_to_mantissa_exponent(double value, char (&buffer)[32], char** out_mantissa, int* out_exponent)
+	{
+		// get a scientific notation value with IEEE DBL_DIG decimals
+		PUGI_IMPL_SNPRINTF(buffer, "%.*e", DBL_DIG, value);
+
+		// get the exponent (possibly negative)
+		char* exponent_string = strchr(buffer, 'e');
+		assert(exponent_string);
+
+		int exponent = atoi(exponent_string + 1);
+
+		// extract mantissa string: skip sign
+		char* mantissa = buffer[0] == '-' ? buffer + 1 : buffer;
+		assert(mantissa[0] != '0' && (mantissa[1] == '.' || mantissa[1] == ','));
+
+		// divide mantissa by 10 to eliminate integer part
+		mantissa[1] = mantissa[0];
+		mantissa++;
+		exponent++;
+
+		// remove extra mantissa digits and zero-terminate mantissa
+		truncate_zeros(mantissa, exponent_string);
+
+		// fill results
+		*out_mantissa = mantissa;
+		*out_exponent = exponent;
+	}
+#endif
+
+	PUGI_IMPL_FN xpath_string convert_number_to_string(double value, xpath_allocator* alloc)
+	{
+		// try special number conversion
+		const char_t* special = convert_number_to_string_special(value);
+		if (special) return xpath_string::from_const(special);
+
+		// get mantissa + exponent form
+		char mantissa_buffer[32];
+
+		char* mantissa;
+		int exponent;
+		convert_number_to_mantissa_exponent(value, mantissa_buffer, &mantissa, &exponent);
+
+		// allocate a buffer of suitable length for the number
+		size_t result_size = strlen(mantissa_buffer) + (exponent > 0 ? exponent : -exponent) + 4;
+		char_t* result = static_cast<char_t*>(alloc->allocate(sizeof(char_t) * result_size));
+		if (!result) return xpath_string();
+
+		// make the number!
+		char_t* s = result;
+
+		// sign
+		if (value < 0) *s++ = '-';
+
+		// integer part
+		if (exponent <= 0)
+		{
+			*s++ = '0';
+		}
+		else
+		{
+			while (exponent > 0)
+			{
+				assert(*mantissa == 0 || static_cast<unsigned int>(*mantissa - '0') <= 9);
+				*s++ = *mantissa ? *mantissa++ : '0';
+				exponent--;
+			}
+		}
+
+		// fractional part
+		if (*mantissa)
+		{
+			// decimal point
+			*s++ = '.';
+
+			// extra zeroes from negative exponent
+			while (exponent < 0)
+			{
+				*s++ = '0';
+				exponent++;
+			}
+
+			// extra mantissa digits
+			while (*mantissa)
+			{
+				assert(static_cast<unsigned int>(*mantissa - '0') <= 9);
+				*s++ = *mantissa++;
+			}
+		}
+
+		// zero-terminate
+		assert(s < result + result_size);
+		*s = 0;
+
+		return xpath_string::from_heap_preallocated(result, s);
+	}
+
+	PUGI_IMPL_FN bool check_string_to_number_format(const char_t* string)
+	{
+		// parse leading whitespace
+		while (PUGI_IMPL_IS_CHARTYPE(*string, ct_space)) ++string;
+
+		// parse sign
+		if (*string == '-') ++string;
+
+		if (!*string) return false;
+
+		// if there is no integer part, there should be a decimal part with at least one digit
+		if (!PUGI_IMPL_IS_CHARTYPEX(string[0], ctx_digit) && (string[0] != '.' || !PUGI_IMPL_IS_CHARTYPEX(string[1], ctx_digit))) return false;
+
+		// parse integer part
+		while (PUGI_IMPL_IS_CHARTYPEX(*string, ctx_digit)) ++string;
+
+		// parse decimal part
+		if (*string == '.')
+		{
+			++string;
+
+			while (PUGI_IMPL_IS_CHARTYPEX(*string, ctx_digit)) ++string;
+		}
+
+		// parse trailing whitespace
+		while (PUGI_IMPL_IS_CHARTYPE(*string, ct_space)) ++string;
+
+		return *string == 0;
+	}
+
+	PUGI_IMPL_FN double convert_string_to_number(const char_t* string)
+	{
+		// check string format
+		if (!check_string_to_number_format(string)) return gen_nan();
+
+		// parse string
+	#ifdef PUGIXML_WCHAR_MODE
+		return wcstod(string, 0);
+	#else
+		return strtod(string, 0);
+	#endif
+	}
+
+	PUGI_IMPL_FN bool convert_string_to_number_scratch(char_t (&buffer)[32], const char_t* begin, const char_t* end, double* out_result)
+	{
+		size_t length = static_cast<size_t>(end - begin);
+		char_t* scratch = buffer;
+
+		if (length >= sizeof(buffer) / sizeof(buffer[0]))
+		{
+			// need to make dummy on-heap copy
+			scratch = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+			if (!scratch) return false;
+		}
+
+		// copy string to zero-terminated buffer and perform conversion
+		memcpy(scratch, begin, length * sizeof(char_t));
+		scratch[length] = 0;
+
+		*out_result = convert_string_to_number(scratch);
+
+		// free dummy buffer
+		if (scratch != buffer) xml_memory::deallocate(scratch);
+
+		return true;
+	}
+
+	PUGI_IMPL_FN double round_nearest(double value)
+	{
+		return floor(value + 0.5);
+	}
+
+	PUGI_IMPL_FN double round_nearest_nzero(double value)
+	{
+		// same as round_nearest, but returns -0 for [-0.5, -0]
+		// ceil is used to differentiate between +0 and -0 (we return -0 for [-0.5, -0] and +0 for +0)
+		return (value >= -0.5 && value <= 0) ? ceil(value) : floor(value + 0.5);
+	}
+
+	PUGI_IMPL_FN const char_t* qualified_name(const xpath_node& node)
+	{
+		return node.attribute() ? node.attribute().name() : node.node().name();
+	}
+
+	PUGI_IMPL_FN const char_t* local_name(const xpath_node& node)
+	{
+		const char_t* name = qualified_name(node);
+		const char_t* p = find_char(name, ':');
+
+		return p ? p + 1 : name;
+	}
+
+	struct namespace_uri_predicate
+	{
+		const char_t* prefix;
+		size_t prefix_length;
+
+		namespace_uri_predicate(const char_t* name)
+		{
+			const char_t* pos = find_char(name, ':');
+
+			prefix = pos ? name : 0;
+			prefix_length = pos ? static_cast<size_t>(pos - name) : 0;
+		}
+
+		bool operator()(xml_attribute a) const
+		{
+			const char_t* name = a.name();
+
+			if (!starts_with(name, PUGIXML_TEXT("xmlns"))) return false;
+
+			return prefix ? name[5] == ':' && strequalrange(name + 6, prefix, prefix_length) : name[5] == 0;
+		}
+	};
+
+	PUGI_IMPL_FN const char_t* namespace_uri(xml_node node)
+	{
+		namespace_uri_predicate pred = node.name();
+
+		xml_node p = node;
+
+		while (p)
+		{
+			xml_attribute a = p.find_attribute(pred);
+
+			if (a) return a.value();
+
+			p = p.parent();
+		}
+
+		return PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const char_t* namespace_uri(xml_attribute attr, xml_node parent)
+	{
+		namespace_uri_predicate pred = attr.name();
+
+		// Default namespace does not apply to attributes
+		if (!pred.prefix) return PUGIXML_TEXT("");
+
+		xml_node p = parent;
+
+		while (p)
+		{
+			xml_attribute a = p.find_attribute(pred);
+
+			if (a) return a.value();
+
+			p = p.parent();
+		}
+
+		return PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const char_t* namespace_uri(const xpath_node& node)
+	{
+		return node.attribute() ? namespace_uri(node.attribute(), node.parent()) : namespace_uri(node.node());
+	}
+
+	PUGI_IMPL_FN char_t* normalize_space(char_t* buffer)
+	{
+		char_t* write = buffer;
+
+		for (char_t* it = buffer; *it; )
+		{
+			char_t ch = *it++;
+
+			if (PUGI_IMPL_IS_CHARTYPE(ch, ct_space))
+			{
+				// replace whitespace sequence with single space
+				while (PUGI_IMPL_IS_CHARTYPE(*it, ct_space)) it++;
+
+				// avoid leading spaces
+				if (write != buffer) *write++ = ' ';
+			}
+			else *write++ = ch;
+		}
+
+		// remove trailing space
+		if (write != buffer && PUGI_IMPL_IS_CHARTYPE(write[-1], ct_space)) write--;
+
+		// zero-terminate
+		*write = 0;
+
+		return write;
+	}
+
+	PUGI_IMPL_FN char_t* translate(char_t* buffer, const char_t* from, const char_t* to, size_t to_length)
+	{
+		char_t* write = buffer;
+
+		while (*buffer)
+		{
+			PUGI_IMPL_DMC_VOLATILE char_t ch = *buffer++;
+
+			const char_t* pos = find_char(from, ch);
+
+			if (!pos)
+				*write++ = ch; // do not process
+			else if (static_cast<size_t>(pos - from) < to_length)
+				*write++ = to[pos - from]; // replace
+		}
+
+		// zero-terminate
+		*write = 0;
+
+		return write;
+	}
+
+	PUGI_IMPL_FN unsigned char* translate_table_generate(xpath_allocator* alloc, const char_t* from, const char_t* to)
+	{
+		unsigned char table[128] = {0};
+
+		while (*from)
+		{
+			unsigned int fc = static_cast<unsigned int>(*from);
+			unsigned int tc = static_cast<unsigned int>(*to);
+
+			if (fc >= 128 || tc >= 128)
+				return 0;
+
+			// code=128 means "skip character"
+			if (!table[fc])
+				table[fc] = static_cast<unsigned char>(tc ? tc : 128);
+
+			from++;
+			if (tc) to++;
+		}
+
+		for (int i = 0; i < 128; ++i)
+			if (!table[i])
+				table[i] = static_cast<unsigned char>(i);
+
+		void* result = alloc->allocate(sizeof(table));
+		if (!result) return 0;
+
+		memcpy(result, table, sizeof(table));
+
+		return static_cast<unsigned char*>(result);
+	}
+
+	PUGI_IMPL_FN char_t* translate_table(char_t* buffer, const unsigned char* table)
+	{
+		char_t* write = buffer;
+
+		while (*buffer)
+		{
+			char_t ch = *buffer++;
+			unsigned int index = static_cast<unsigned int>(ch);
+
+			if (index < 128)
+			{
+				unsigned char code = table[index];
+
+				// code=128 means "skip character" (table size is 128 so 128 can be a special value)
+				// this code skips these characters without extra branches
+				*write = static_cast<char_t>(code);
+				write += 1 - (code >> 7);
+			}
+			else
+			{
+				*write++ = ch;
+			}
+		}
+
+		// zero-terminate
+		*write = 0;
+
+		return write;
+	}
+
+	inline bool is_xpath_attribute(const char_t* name)
+	{
+		return !(starts_with(name, PUGIXML_TEXT("xmlns")) && (name[5] == 0 || name[5] == ':'));
+	}
+
+	struct xpath_variable_boolean: xpath_variable
+	{
+		xpath_variable_boolean(): xpath_variable(xpath_type_boolean), value(false)
+		{
+		}
+
+		bool value;
+		char_t name[1];
+	};
+
+	struct xpath_variable_number: xpath_variable
+	{
+		xpath_variable_number(): xpath_variable(xpath_type_number), value(0)
+		{
+		}
+
+		double value;
+		char_t name[1];
+	};
+
+	struct xpath_variable_string: xpath_variable
+	{
+		xpath_variable_string(): xpath_variable(xpath_type_string), value(0)
+		{
+		}
+
+		~xpath_variable_string()
+		{
+			if (value) xml_memory::deallocate(value);
+		}
+
+		char_t* value;
+		char_t name[1];
+	};
+
+	struct xpath_variable_node_set: xpath_variable
+	{
+		xpath_variable_node_set(): xpath_variable(xpath_type_node_set)
+		{
+		}
+
+		xpath_node_set value;
+		char_t name[1];
+	};
+
+	static const xpath_node_set dummy_node_set;
+
+	PUGI_IMPL_FN PUGI_IMPL_UNSIGNED_OVERFLOW unsigned int hash_string(const char_t* str)
+	{
+		// Jenkins one-at-a-time hash (http://en.wikipedia.org/wiki/Jenkins_hash_function#one-at-a-time)
+		unsigned int result = 0;
+
+		while (*str)
+		{
+			result += static_cast<unsigned int>(*str++);
+			result += result << 10;
+			result ^= result >> 6;
+		}
+
+		result += result << 3;
+		result ^= result >> 11;
+		result += result << 15;
+
+		return result;
+	}
+
+	template <typename T> PUGI_IMPL_FN T* new_xpath_variable(const char_t* name)
+	{
+		size_t length = strlength(name);
+		if (length == 0) return 0; // empty variable names are invalid
+
+		// $$ we can't use offsetof(T, name) because T is non-POD, so we just allocate additional length characters
+		void* memory = xml_memory::allocate(sizeof(T) + length * sizeof(char_t));
+		if (!memory) return 0;
+
+		T* result = new (memory) T();
+
+		memcpy(result->name, name, (length + 1) * sizeof(char_t));
+
+		return result;
+	}
+
+	PUGI_IMPL_FN xpath_variable* new_xpath_variable(xpath_value_type type, const char_t* name)
+	{
+		switch (type)
+		{
+		case xpath_type_node_set:
+			return new_xpath_variable<xpath_variable_node_set>(name);
+
+		case xpath_type_number:
+			return new_xpath_variable<xpath_variable_number>(name);
+
+		case xpath_type_string:
+			return new_xpath_variable<xpath_variable_string>(name);
+
+		case xpath_type_boolean:
+			return new_xpath_variable<xpath_variable_boolean>(name);
+
+		default:
+			return 0;
+		}
+	}
+
+	template <typename T> PUGI_IMPL_FN void delete_xpath_variable(T* var)
+	{
+		var->~T();
+		xml_memory::deallocate(var);
+	}
+
+	PUGI_IMPL_FN void delete_xpath_variable(xpath_value_type type, xpath_variable* var)
+	{
+		switch (type)
+		{
+		case xpath_type_node_set:
+			delete_xpath_variable(static_cast<xpath_variable_node_set*>(var));
+			break;
+
+		case xpath_type_number:
+			delete_xpath_variable(static_cast<xpath_variable_number*>(var));
+			break;
+
+		case xpath_type_string:
+			delete_xpath_variable(static_cast<xpath_variable_string*>(var));
+			break;
+
+		case xpath_type_boolean:
+			delete_xpath_variable(static_cast<xpath_variable_boolean*>(var));
+			break;
+
+		default:
+			assert(false && "Invalid variable type"); // unreachable
+		}
+	}
+
+	PUGI_IMPL_FN bool copy_xpath_variable(xpath_variable* lhs, const xpath_variable* rhs)
+	{
+		switch (rhs->type())
+		{
+		case xpath_type_node_set:
+			return lhs->set(static_cast<const xpath_variable_node_set*>(rhs)->value);
+
+		case xpath_type_number:
+			return lhs->set(static_cast<const xpath_variable_number*>(rhs)->value);
+
+		case xpath_type_string:
+			return lhs->set(static_cast<const xpath_variable_string*>(rhs)->value);
+
+		case xpath_type_boolean:
+			return lhs->set(static_cast<const xpath_variable_boolean*>(rhs)->value);
+
+		default:
+			assert(false && "Invalid variable type"); // unreachable
+			return false;
+		}
+	}
+
+	PUGI_IMPL_FN bool get_variable_scratch(char_t (&buffer)[32], xpath_variable_set* set, const char_t* begin, const char_t* end, xpath_variable** out_result)
+	{
+		size_t length = static_cast<size_t>(end - begin);
+		char_t* scratch = buffer;
+
+		if (length >= sizeof(buffer) / sizeof(buffer[0]))
+		{
+			// need to make dummy on-heap copy
+			scratch = static_cast<char_t*>(xml_memory::allocate((length + 1) * sizeof(char_t)));
+			if (!scratch) return false;
+		}
+
+		// copy string to zero-terminated buffer and perform lookup
+		memcpy(scratch, begin, length * sizeof(char_t));
+		scratch[length] = 0;
+
+		*out_result = set->get(scratch);
+
+		// free dummy buffer
+		if (scratch != buffer) xml_memory::deallocate(scratch);
+
+		return true;
+	}
+PUGI_IMPL_NS_END
+
+// Internal node set class
+PUGI_IMPL_NS_BEGIN
+	PUGI_IMPL_FN xpath_node_set::type_t xpath_get_order(const xpath_node* begin, const xpath_node* end)
+	{
+		if (end - begin < 2)
+			return xpath_node_set::type_sorted;
+
+		document_order_comparator cmp;
+
+		bool first = cmp(begin[0], begin[1]);
+
+		for (const xpath_node* it = begin + 1; it + 1 < end; ++it)
+			if (cmp(it[0], it[1]) != first)
+				return xpath_node_set::type_unsorted;
+
+		return first ? xpath_node_set::type_sorted : xpath_node_set::type_sorted_reverse;
+	}
+
+	PUGI_IMPL_FN xpath_node_set::type_t xpath_sort(xpath_node* begin, xpath_node* end, xpath_node_set::type_t type, bool rev)
+	{
+		xpath_node_set::type_t order = rev ? xpath_node_set::type_sorted_reverse : xpath_node_set::type_sorted;
+
+		if (type == xpath_node_set::type_unsorted)
+		{
+			xpath_node_set::type_t sorted = xpath_get_order(begin, end);
+
+			if (sorted == xpath_node_set::type_unsorted)
+			{
+				sort(begin, end, document_order_comparator());
+
+				type = xpath_node_set::type_sorted;
+			}
+			else
+				type = sorted;
+		}
+
+		if (type != order) reverse(begin, end);
+
+		return order;
+	}
+
+	PUGI_IMPL_FN xpath_node xpath_first(const xpath_node* begin, const xpath_node* end, xpath_node_set::type_t type)
+	{
+		if (begin == end) return xpath_node();
+
+		switch (type)
+		{
+		case xpath_node_set::type_sorted:
+			return *begin;
+
+		case xpath_node_set::type_sorted_reverse:
+			return *(end - 1);
+
+		case xpath_node_set::type_unsorted:
+			return *min_element(begin, end, document_order_comparator());
+
+		default:
+			assert(false && "Invalid node set type"); // unreachable
+			return xpath_node();
+		}
+	}
+
+	class xpath_node_set_raw
+	{
+		xpath_node_set::type_t _type;
+
+		xpath_node* _begin;
+		xpath_node* _end;
+		xpath_node* _eos;
+
+	public:
+		xpath_node_set_raw(): _type(xpath_node_set::type_unsorted), _begin(0), _end(0), _eos(0)
+		{
+		}
+
+		xpath_node* begin() const
+		{
+			return _begin;
+		}
+
+		xpath_node* end() const
+		{
+			return _end;
+		}
+
+		bool empty() const
+		{
+			return _begin == _end;
+		}
+
+		size_t size() const
+		{
+			return static_cast<size_t>(_end - _begin);
+		}
+
+		xpath_node first() const
+		{
+			return xpath_first(_begin, _end, _type);
+		}
+
+		void push_back_grow(const xpath_node& node, xpath_allocator* alloc);
+
+		void push_back(const xpath_node& node, xpath_allocator* alloc)
+		{
+			if (_end != _eos)
+				*_end++ = node;
+			else
+				push_back_grow(node, alloc);
+		}
+
+		void append(const xpath_node* begin_, const xpath_node* end_, xpath_allocator* alloc)
+		{
+			if (begin_ == end_) return;
+
+			size_t size_ = static_cast<size_t>(_end - _begin);
+			size_t capacity = static_cast<size_t>(_eos - _begin);
+			size_t count = static_cast<size_t>(end_ - begin_);
+
+			if (size_ + count > capacity)
+			{
+				// reallocate the old array or allocate a new one
+				xpath_node* data = static_cast<xpath_node*>(alloc->reallocate(_begin, capacity * sizeof(xpath_node), (size_ + count) * sizeof(xpath_node)));
+				if (!data) return;
+
+				// finalize
+				_begin = data;
+				_end = data + size_;
+				_eos = data + size_ + count;
+			}
+
+			memcpy(_end, begin_, count * sizeof(xpath_node));
+			_end += count;
+		}
+
+		void sort_do()
+		{
+			_type = xpath_sort(_begin, _end, _type, false);
+		}
+
+		void truncate(xpath_node* pos)
+		{
+			assert(_begin <= pos && pos <= _end);
+
+			_end = pos;
+		}
+
+		void remove_duplicates(xpath_allocator* alloc)
+		{
+			if (_type == xpath_node_set::type_unsorted && _end - _begin > 2)
+			{
+				xpath_allocator_capture cr(alloc);
+
+				size_t size_ = static_cast<size_t>(_end - _begin);
+
+				size_t hash_size = 1;
+				while (hash_size < size_ + size_ / 2) hash_size *= 2;
+
+				const void** hash_data = static_cast<const void**>(alloc->allocate(hash_size * sizeof(void**)));
+				if (!hash_data) return;
+
+				memset(hash_data, 0, hash_size * sizeof(const void**));
+
+				xpath_node* write = _begin;
+
+				for (xpath_node* it = _begin; it != _end; ++it)
+				{
+					const void* attr = it->attribute().internal_object();
+					const void* node = it->node().internal_object();
+					const void* key = attr ? attr : node;
+
+					if (key && hash_insert(hash_data, hash_size, key))
+					{
+						*write++ = *it;
+					}
+				}
+
+				_end = write;
+			}
+			else
+			{
+				_end = unique(_begin, _end);
+			}
+		}
+
+		xpath_node_set::type_t type() const
+		{
+			return _type;
+		}
+
+		void set_type(xpath_node_set::type_t value)
+		{
+			_type = value;
+		}
+	};
+
+	PUGI_IMPL_FN_NO_INLINE void xpath_node_set_raw::push_back_grow(const xpath_node& node, xpath_allocator* alloc)
+	{
+		size_t capacity = static_cast<size_t>(_eos - _begin);
+
+		// get new capacity (1.5x rule)
+		size_t new_capacity = capacity + capacity / 2 + 1;
+
+		// reallocate the old array or allocate a new one
+		xpath_node* data = static_cast<xpath_node*>(alloc->reallocate(_begin, capacity * sizeof(xpath_node), new_capacity * sizeof(xpath_node)));
+		if (!data) return;
+
+		// finalize
+		_begin = data;
+		_end = data + capacity;
+		_eos = data + new_capacity;
+
+		// push
+		*_end++ = node;
+	}
+PUGI_IMPL_NS_END
+
+PUGI_IMPL_NS_BEGIN
+	struct xpath_context
+	{
+		xpath_node n;
+		size_t position, size;
+
+		xpath_context(const xpath_node& n_, size_t position_, size_t size_): n(n_), position(position_), size(size_)
+		{
+		}
+	};
+
+	enum lexeme_t
+	{
+		lex_none = 0,
+		lex_equal,
+		lex_not_equal,
+		lex_less,
+		lex_greater,
+		lex_less_or_equal,
+		lex_greater_or_equal,
+		lex_plus,
+		lex_minus,
+		lex_multiply,
+		lex_union,
+		lex_var_ref,
+		lex_open_brace,
+		lex_close_brace,
+		lex_quoted_string,
+		lex_number,
+		lex_slash,
+		lex_double_slash,
+		lex_open_square_brace,
+		lex_close_square_brace,
+		lex_string,
+		lex_comma,
+		lex_axis_attribute,
+		lex_dot,
+		lex_double_dot,
+		lex_double_colon,
+		lex_eof
+	};
+
+	struct xpath_lexer_string
+	{
+		const char_t* begin;
+		const char_t* end;
+
+		xpath_lexer_string(): begin(0), end(0)
+		{
+		}
+
+		bool operator==(const char_t* other) const
+		{
+			size_t length = static_cast<size_t>(end - begin);
+
+			return strequalrange(other, begin, length);
+		}
+	};
+
+	class xpath_lexer
+	{
+		const char_t* _cur;
+		const char_t* _cur_lexeme_pos;
+		xpath_lexer_string _cur_lexeme_contents;
+
+		lexeme_t _cur_lexeme;
+
+	public:
+		explicit xpath_lexer(const char_t* query): _cur(query)
+		{
+			next();
+		}
+
+		const char_t* state() const
+		{
+			return _cur;
+		}
+
+		void next()
+		{
+			const char_t* cur = _cur;
+
+			while (PUGI_IMPL_IS_CHARTYPE(*cur, ct_space)) ++cur;
+
+			// save lexeme position for error reporting
+			_cur_lexeme_pos = cur;
+
+			switch (*cur)
+			{
+			case 0:
+				_cur_lexeme = lex_eof;
+				break;
+
+			case '>':
+				if (*(cur+1) == '=')
+				{
+					cur += 2;
+					_cur_lexeme = lex_greater_or_equal;
+				}
+				else
+				{
+					cur += 1;
+					_cur_lexeme = lex_greater;
+				}
+				break;
+
+			case '<':
+				if (*(cur+1) == '=')
+				{
+					cur += 2;
+					_cur_lexeme = lex_less_or_equal;
+				}
+				else
+				{
+					cur += 1;
+					_cur_lexeme = lex_less;
+				}
+				break;
+
+			case '!':
+				if (*(cur+1) == '=')
+				{
+					cur += 2;
+					_cur_lexeme = lex_not_equal;
+				}
+				else
+				{
+					_cur_lexeme = lex_none;
+				}
+				break;
+
+			case '=':
+				cur += 1;
+				_cur_lexeme = lex_equal;
+
+				break;
+
+			case '+':
+				cur += 1;
+				_cur_lexeme = lex_plus;
+
+				break;
+
+			case '-':
+				cur += 1;
+				_cur_lexeme = lex_minus;
+
+				break;
+
+			case '*':
+				cur += 1;
+				_cur_lexeme = lex_multiply;
+
+				break;
+
+			case '|':
+				cur += 1;
+				_cur_lexeme = lex_union;
+
+				break;
+
+			case '$':
+				cur += 1;
+
+				if (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_start_symbol))
+				{
+					_cur_lexeme_contents.begin = cur;
+
+					while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_symbol)) cur++;
+
+					if (cur[0] == ':' && PUGI_IMPL_IS_CHARTYPEX(cur[1], ctx_symbol)) // qname
+					{
+						cur++; // :
+
+						while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_symbol)) cur++;
+					}
+
+					_cur_lexeme_contents.end = cur;
+
+					_cur_lexeme = lex_var_ref;
+				}
+				else
+				{
+					_cur_lexeme = lex_none;
+				}
+
+				break;
+
+			case '(':
+				cur += 1;
+				_cur_lexeme = lex_open_brace;
+
+				break;
+
+			case ')':
+				cur += 1;
+				_cur_lexeme = lex_close_brace;
+
+				break;
+
+			case '[':
+				cur += 1;
+				_cur_lexeme = lex_open_square_brace;
+
+				break;
+
+			case ']':
+				cur += 1;
+				_cur_lexeme = lex_close_square_brace;
+
+				break;
+
+			case ',':
+				cur += 1;
+				_cur_lexeme = lex_comma;
+
+				break;
+
+			case '/':
+				if (*(cur+1) == '/')
+				{
+					cur += 2;
+					_cur_lexeme = lex_double_slash;
+				}
+				else
+				{
+					cur += 1;
+					_cur_lexeme = lex_slash;
+				}
+				break;
+
+			case '.':
+				if (*(cur+1) == '.')
+				{
+					cur += 2;
+					_cur_lexeme = lex_double_dot;
+				}
+				else if (PUGI_IMPL_IS_CHARTYPEX(*(cur+1), ctx_digit))
+				{
+					_cur_lexeme_contents.begin = cur; // .
+
+					++cur;
+
+					while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_digit)) cur++;
+
+					_cur_lexeme_contents.end = cur;
+
+					_cur_lexeme = lex_number;
+				}
+				else
+				{
+					cur += 1;
+					_cur_lexeme = lex_dot;
+				}
+				break;
+
+			case '@':
+				cur += 1;
+				_cur_lexeme = lex_axis_attribute;
+
+				break;
+
+			case '"':
+			case '\'':
+			{
+				char_t terminator = *cur;
+
+				++cur;
+
+				_cur_lexeme_contents.begin = cur;
+				while (*cur && *cur != terminator) cur++;
+				_cur_lexeme_contents.end = cur;
+
+				if (!*cur)
+					_cur_lexeme = lex_none;
+				else
+				{
+					cur += 1;
+					_cur_lexeme = lex_quoted_string;
+				}
+
+				break;
+			}
+
+			case ':':
+				if (*(cur+1) == ':')
+				{
+					cur += 2;
+					_cur_lexeme = lex_double_colon;
+				}
+				else
+				{
+					_cur_lexeme = lex_none;
+				}
+				break;
+
+			default:
+				if (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_digit))
+				{
+					_cur_lexeme_contents.begin = cur;
+
+					while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_digit)) cur++;
+
+					if (*cur == '.')
+					{
+						cur++;
+
+						while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_digit)) cur++;
+					}
+
+					_cur_lexeme_contents.end = cur;
+
+					_cur_lexeme = lex_number;
+				}
+				else if (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_start_symbol))
+				{
+					_cur_lexeme_contents.begin = cur;
+
+					while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_symbol)) cur++;
+
+					if (cur[0] == ':')
+					{
+						if (cur[1] == '*') // namespace test ncname:*
+						{
+							cur += 2; // :*
+						}
+						else if (PUGI_IMPL_IS_CHARTYPEX(cur[1], ctx_symbol)) // namespace test qname
+						{
+							cur++; // :
+
+							while (PUGI_IMPL_IS_CHARTYPEX(*cur, ctx_symbol)) cur++;
+						}
+					}
+
+					_cur_lexeme_contents.end = cur;
+
+					_cur_lexeme = lex_string;
+				}
+				else
+				{
+					_cur_lexeme = lex_none;
+				}
+			}
+
+			_cur = cur;
+		}
+
+		lexeme_t current() const
+		{
+			return _cur_lexeme;
+		}
+
+		const char_t* current_pos() const
+		{
+			return _cur_lexeme_pos;
+		}
+
+		const xpath_lexer_string& contents() const
+		{
+			assert(_cur_lexeme == lex_var_ref || _cur_lexeme == lex_number || _cur_lexeme == lex_string || _cur_lexeme == lex_quoted_string);
+
+			return _cur_lexeme_contents;
+		}
+	};
+
+	enum ast_type_t
+	{
+		ast_unknown,
+		ast_op_or,						// left or right
+		ast_op_and,						// left and right
+		ast_op_equal,					// left = right
+		ast_op_not_equal,				// left != right
+		ast_op_less,					// left < right
+		ast_op_greater,					// left > right
+		ast_op_less_or_equal,			// left <= right
+		ast_op_greater_or_equal,		// left >= right
+		ast_op_add,						// left + right
+		ast_op_subtract,				// left - right
+		ast_op_multiply,				// left * right
+		ast_op_divide,					// left / right
+		ast_op_mod,						// left % right
+		ast_op_negate,					// left - right
+		ast_op_union,					// left | right
+		ast_predicate,					// apply predicate to set; next points to next predicate
+		ast_filter,						// select * from left where right
+		ast_string_constant,			// string constant
+		ast_number_constant,			// number constant
+		ast_variable,					// variable
+		ast_func_last,					// last()
+		ast_func_position,				// position()
+		ast_func_count,					// count(left)
+		ast_func_id,					// id(left)
+		ast_func_local_name_0,			// local-name()
+		ast_func_local_name_1,			// local-name(left)
+		ast_func_namespace_uri_0,		// namespace-uri()
+		ast_func_namespace_uri_1,		// namespace-uri(left)
+		ast_func_name_0,				// name()
+		ast_func_name_1,				// name(left)
+		ast_func_string_0,				// string()
+		ast_func_string_1,				// string(left)
+		ast_func_concat,				// concat(left, right, siblings)
+		ast_func_starts_with,			// starts_with(left, right)
+		ast_func_contains,				// contains(left, right)
+		ast_func_substring_before,		// substring-before(left, right)
+		ast_func_substring_after,		// substring-after(left, right)
+		ast_func_substring_2,			// substring(left, right)
+		ast_func_substring_3,			// substring(left, right, third)
+		ast_func_string_length_0,		// string-length()
+		ast_func_string_length_1,		// string-length(left)
+		ast_func_normalize_space_0,		// normalize-space()
+		ast_func_normalize_space_1,		// normalize-space(left)
+		ast_func_translate,				// translate(left, right, third)
+		ast_func_boolean,				// boolean(left)
+		ast_func_not,					// not(left)
+		ast_func_true,					// true()
+		ast_func_false,					// false()
+		ast_func_lang,					// lang(left)
+		ast_func_number_0,				// number()
+		ast_func_number_1,				// number(left)
+		ast_func_sum,					// sum(left)
+		ast_func_floor,					// floor(left)
+		ast_func_ceiling,				// ceiling(left)
+		ast_func_round,					// round(left)
+		ast_step,						// process set left with step
+		ast_step_root,					// select root node
+
+		ast_opt_translate_table,		// translate(left, right, third) where right/third are constants
+		ast_opt_compare_attribute		// @name = 'string'
+	};
+
+	enum axis_t
+	{
+		axis_ancestor,
+		axis_ancestor_or_self,
+		axis_attribute,
+		axis_child,
+		axis_descendant,
+		axis_descendant_or_self,
+		axis_following,
+		axis_following_sibling,
+		axis_namespace,
+		axis_parent,
+		axis_preceding,
+		axis_preceding_sibling,
+		axis_self
+	};
+
+	enum nodetest_t
+	{
+		nodetest_none,
+		nodetest_name,
+		nodetest_type_node,
+		nodetest_type_comment,
+		nodetest_type_pi,
+		nodetest_type_text,
+		nodetest_pi,
+		nodetest_all,
+		nodetest_all_in_namespace
+	};
+
+	enum predicate_t
+	{
+		predicate_default,
+		predicate_posinv,
+		predicate_constant,
+		predicate_constant_one
+	};
+
+	enum nodeset_eval_t
+	{
+		nodeset_eval_all,
+		nodeset_eval_any,
+		nodeset_eval_first
+	};
+
+	template <axis_t N> struct axis_to_type
+	{
+		static const axis_t axis;
+	};
+
+	template <axis_t N> const axis_t axis_to_type<N>::axis = N;
+
+	class xpath_ast_node
+	{
+	private:
+		// node type
+		char _type;
+		char _rettype;
+
+		// for ast_step
+		char _axis;
+
+		// for ast_step/ast_predicate/ast_filter
+		char _test;
+
+		// tree node structure
+		xpath_ast_node* _left;
+		xpath_ast_node* _right;
+		xpath_ast_node* _next;
+
+		union
+		{
+			// value for ast_string_constant
+			const char_t* string;
+			// value for ast_number_constant
+			double number;
+			// variable for ast_variable
+			xpath_variable* variable;
+			// node test for ast_step (node name/namespace/node type/pi target)
+			const char_t* nodetest;
+			// table for ast_opt_translate_table
+			const unsigned char* table;
+		} _data;
+
+		xpath_ast_node(const xpath_ast_node&);
+		xpath_ast_node& operator=(const xpath_ast_node&);
+
+		template <class Comp> static bool compare_eq(xpath_ast_node* lhs, xpath_ast_node* rhs, const xpath_context& c, const xpath_stack& stack, const Comp& comp)
+		{
+			xpath_value_type lt = lhs->rettype(), rt = rhs->rettype();
+
+			if (lt != xpath_type_node_set && rt != xpath_type_node_set)
+			{
+				if (lt == xpath_type_boolean || rt == xpath_type_boolean)
+					return comp(lhs->eval_boolean(c, stack), rhs->eval_boolean(c, stack));
+				else if (lt == xpath_type_number || rt == xpath_type_number)
+					return comp(lhs->eval_number(c, stack), rhs->eval_number(c, stack));
+				else if (lt == xpath_type_string || rt == xpath_type_string)
+				{
+					xpath_allocator_capture cr(stack.result);
+
+					xpath_string ls = lhs->eval_string(c, stack);
+					xpath_string rs = rhs->eval_string(c, stack);
+
+					return comp(ls, rs);
+				}
+			}
+			else if (lt == xpath_type_node_set && rt == xpath_type_node_set)
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ls = lhs->eval_node_set(c, stack, nodeset_eval_all);
+				xpath_node_set_raw rs = rhs->eval_node_set(c, stack, nodeset_eval_all);
+
+				for (const xpath_node* li = ls.begin(); li != ls.end(); ++li)
+					for (const xpath_node* ri = rs.begin(); ri != rs.end(); ++ri)
+					{
+						xpath_allocator_capture cri(stack.result);
+
+						if (comp(string_value(*li, stack.result), string_value(*ri, stack.result)))
+							return true;
+					}
+
+				return false;
+			}
+			else
+			{
+				if (lt == xpath_type_node_set)
+				{
+					swap(lhs, rhs);
+					swap(lt, rt);
+				}
+
+				if (lt == xpath_type_boolean)
+					return comp(lhs->eval_boolean(c, stack), rhs->eval_boolean(c, stack));
+				else if (lt == xpath_type_number)
+				{
+					xpath_allocator_capture cr(stack.result);
+
+					double l = lhs->eval_number(c, stack);
+					xpath_node_set_raw rs = rhs->eval_node_set(c, stack, nodeset_eval_all);
+
+					for (const xpath_node* ri = rs.begin(); ri != rs.end(); ++ri)
+					{
+						xpath_allocator_capture cri(stack.result);
+
+						if (comp(l, convert_string_to_number(string_value(*ri, stack.result).c_str())))
+							return true;
+					}
+
+					return false;
+				}
+				else if (lt == xpath_type_string)
+				{
+					xpath_allocator_capture cr(stack.result);
+
+					xpath_string l = lhs->eval_string(c, stack);
+					xpath_node_set_raw rs = rhs->eval_node_set(c, stack, nodeset_eval_all);
+
+					for (const xpath_node* ri = rs.begin(); ri != rs.end(); ++ri)
+					{
+						xpath_allocator_capture cri(stack.result);
+
+						if (comp(l, string_value(*ri, stack.result)))
+							return true;
+					}
+
+					return false;
+				}
+			}
+
+			assert(false && "Wrong types"); // unreachable
+			return false;
+		}
+
+		static bool eval_once(xpath_node_set::type_t type, nodeset_eval_t eval)
+		{
+			return type == xpath_node_set::type_sorted ? eval != nodeset_eval_all : eval == nodeset_eval_any;
+		}
+
+		template <class Comp> static bool compare_rel(xpath_ast_node* lhs, xpath_ast_node* rhs, const xpath_context& c, const xpath_stack& stack, const Comp& comp)
+		{
+			xpath_value_type lt = lhs->rettype(), rt = rhs->rettype();
+
+			if (lt != xpath_type_node_set && rt != xpath_type_node_set)
+				return comp(lhs->eval_number(c, stack), rhs->eval_number(c, stack));
+			else if (lt == xpath_type_node_set && rt == xpath_type_node_set)
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ls = lhs->eval_node_set(c, stack, nodeset_eval_all);
+				xpath_node_set_raw rs = rhs->eval_node_set(c, stack, nodeset_eval_all);
+
+				for (const xpath_node* li = ls.begin(); li != ls.end(); ++li)
+				{
+					xpath_allocator_capture cri(stack.result);
+
+					double l = convert_string_to_number(string_value(*li, stack.result).c_str());
+
+					for (const xpath_node* ri = rs.begin(); ri != rs.end(); ++ri)
+					{
+						xpath_allocator_capture crii(stack.result);
+
+						if (comp(l, convert_string_to_number(string_value(*ri, stack.result).c_str())))
+							return true;
+					}
+				}
+
+				return false;
+			}
+			else if (lt != xpath_type_node_set && rt == xpath_type_node_set)
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				double l = lhs->eval_number(c, stack);
+				xpath_node_set_raw rs = rhs->eval_node_set(c, stack, nodeset_eval_all);
+
+				for (const xpath_node* ri = rs.begin(); ri != rs.end(); ++ri)
+				{
+					xpath_allocator_capture cri(stack.result);
+
+					if (comp(l, convert_string_to_number(string_value(*ri, stack.result).c_str())))
+						return true;
+				}
+
+				return false;
+			}
+			else if (lt == xpath_type_node_set && rt != xpath_type_node_set)
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ls = lhs->eval_node_set(c, stack, nodeset_eval_all);
+				double r = rhs->eval_number(c, stack);
+
+				for (const xpath_node* li = ls.begin(); li != ls.end(); ++li)
+				{
+					xpath_allocator_capture cri(stack.result);
+
+					if (comp(convert_string_to_number(string_value(*li, stack.result).c_str()), r))
+						return true;
+				}
+
+				return false;
+			}
+			else
+			{
+				assert(false && "Wrong types"); // unreachable
+				return false;
+			}
+		}
+
+		static void apply_predicate_boolean(xpath_node_set_raw& ns, size_t first, xpath_ast_node* expr, const xpath_stack& stack, bool once)
+		{
+			assert(ns.size() >= first);
+			assert(expr->rettype() != xpath_type_number);
+
+			size_t i = 1;
+			size_t size = ns.size() - first;
+
+			xpath_node* last = ns.begin() + first;
+
+			// remove_if... or well, sort of
+			for (xpath_node* it = last; it != ns.end(); ++it, ++i)
+			{
+				xpath_context c(*it, i, size);
+
+				if (expr->eval_boolean(c, stack))
+				{
+					*last++ = *it;
+
+					if (once) break;
+				}
+			}
+
+			ns.truncate(last);
+		}
+
+		static void apply_predicate_number(xpath_node_set_raw& ns, size_t first, xpath_ast_node* expr, const xpath_stack& stack, bool once)
+		{
+			assert(ns.size() >= first);
+			assert(expr->rettype() == xpath_type_number);
+
+			size_t i = 1;
+			size_t size = ns.size() - first;
+
+			xpath_node* last = ns.begin() + first;
+
+			// remove_if... or well, sort of
+			for (xpath_node* it = last; it != ns.end(); ++it, ++i)
+			{
+				xpath_context c(*it, i, size);
+
+				if (expr->eval_number(c, stack) == static_cast<double>(i))
+				{
+					*last++ = *it;
+
+					if (once) break;
+				}
+			}
+
+			ns.truncate(last);
+		}
+
+		static void apply_predicate_number_const(xpath_node_set_raw& ns, size_t first, xpath_ast_node* expr, const xpath_stack& stack)
+		{
+			assert(ns.size() >= first);
+			assert(expr->rettype() == xpath_type_number);
+
+			size_t size = ns.size() - first;
+
+			xpath_node* last = ns.begin() + first;
+
+			xpath_node cn;
+			xpath_context c(cn, 1, size);
+
+			double er = expr->eval_number(c, stack);
+
+			if (er >= 1.0 && er <= static_cast<double>(size))
+			{
+				size_t eri = static_cast<size_t>(er);
+
+				if (er == static_cast<double>(eri))
+				{
+					xpath_node r = last[eri - 1];
+
+					*last++ = r;
+				}
+			}
+
+			ns.truncate(last);
+		}
+
+		void apply_predicate(xpath_node_set_raw& ns, size_t first, const xpath_stack& stack, bool once)
+		{
+			if (ns.size() == first) return;
+
+			assert(_type == ast_filter || _type == ast_predicate);
+
+			if (_test == predicate_constant || _test == predicate_constant_one)
+				apply_predicate_number_const(ns, first, _right, stack);
+			else if (_right->rettype() == xpath_type_number)
+				apply_predicate_number(ns, first, _right, stack, once);
+			else
+				apply_predicate_boolean(ns, first, _right, stack, once);
+		}
+
+		void apply_predicates(xpath_node_set_raw& ns, size_t first, const xpath_stack& stack, nodeset_eval_t eval)
+		{
+			if (ns.size() == first) return;
+
+			bool last_once = eval_once(ns.type(), eval);
+
+			for (xpath_ast_node* pred = _right; pred; pred = pred->_next)
+				pred->apply_predicate(ns, first, stack, !pred->_next && last_once);
+		}
+
+		bool step_push(xpath_node_set_raw& ns, xml_attribute_struct* a, xml_node_struct* parent, xpath_allocator* alloc)
+		{
+			assert(a);
+
+			const char_t* name = a->name ? a->name + 0 : PUGIXML_TEXT("");
+
+			switch (_test)
+			{
+			case nodetest_name:
+				if (strequal(name, _data.nodetest) && is_xpath_attribute(name))
+				{
+					ns.push_back(xpath_node(xml_attribute(a), xml_node(parent)), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_type_node:
+			case nodetest_all:
+				if (is_xpath_attribute(name))
+				{
+					ns.push_back(xpath_node(xml_attribute(a), xml_node(parent)), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_all_in_namespace:
+				if (starts_with(name, _data.nodetest) && is_xpath_attribute(name))
+				{
+					ns.push_back(xpath_node(xml_attribute(a), xml_node(parent)), alloc);
+					return true;
+				}
+				break;
+
+			default:
+				;
+			}
+
+			return false;
+		}
+
+		bool step_push(xpath_node_set_raw& ns, xml_node_struct* n, xpath_allocator* alloc)
+		{
+			assert(n);
+
+			xml_node_type type = PUGI_IMPL_NODETYPE(n);
+
+			switch (_test)
+			{
+			case nodetest_name:
+				if (type == node_element && n->name && strequal(n->name, _data.nodetest))
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_type_node:
+				ns.push_back(xml_node(n), alloc);
+				return true;
+
+			case nodetest_type_comment:
+				if (type == node_comment)
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_type_text:
+				if (type == node_pcdata || type == node_cdata)
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_type_pi:
+				if (type == node_pi)
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_pi:
+				if (type == node_pi && n->name && strequal(n->name, _data.nodetest))
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_all:
+				if (type == node_element)
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			case nodetest_all_in_namespace:
+				if (type == node_element && n->name && starts_with(n->name, _data.nodetest))
+				{
+					ns.push_back(xml_node(n), alloc);
+					return true;
+				}
+				break;
+
+			default:
+				assert(false && "Unknown axis"); // unreachable
+			}
+
+			return false;
+		}
+
+		template <class T> void step_fill(xpath_node_set_raw& ns, xml_node_struct* n, xpath_allocator* alloc, bool once, T)
+		{
+			const axis_t axis = T::axis;
+
+			switch (axis)
+			{
+			case axis_attribute:
+			{
+				for (xml_attribute_struct* a = n->first_attribute; a; a = a->next_attribute)
+					if (step_push(ns, a, n, alloc) & once)
+						return;
+
+				break;
+			}
+
+			case axis_child:
+			{
+				for (xml_node_struct* c = n->first_child; c; c = c->next_sibling)
+					if (step_push(ns, c, alloc) & once)
+						return;
+
+				break;
+			}
+
+			case axis_descendant:
+			case axis_descendant_or_self:
+			{
+				if (axis == axis_descendant_or_self)
+					if (step_push(ns, n, alloc) & once)
+						return;
+
+				xml_node_struct* cur = n->first_child;
+
+				while (cur)
+				{
+					if (step_push(ns, cur, alloc) & once)
+						return;
+
+					if (cur->first_child)
+						cur = cur->first_child;
+					else
+					{
+						while (!cur->next_sibling)
+						{
+							cur = cur->parent;
+
+							if (cur == n) return;
+						}
+
+						cur = cur->next_sibling;
+					}
+				}
+
+				break;
+			}
+
+			case axis_following_sibling:
+			{
+				for (xml_node_struct* c = n->next_sibling; c; c = c->next_sibling)
+					if (step_push(ns, c, alloc) & once)
+						return;
+
+				break;
+			}
+
+			case axis_preceding_sibling:
+			{
+				for (xml_node_struct* c = n->prev_sibling_c; c->next_sibling; c = c->prev_sibling_c)
+					if (step_push(ns, c, alloc) & once)
+						return;
+
+				break;
+			}
+
+			case axis_following:
+			{
+				xml_node_struct* cur = n;
+
+				// exit from this node so that we don't include descendants
+				while (!cur->next_sibling)
+				{
+					cur = cur->parent;
+
+					if (!cur) return;
+				}
+
+				cur = cur->next_sibling;
+
+				while (cur)
+				{
+					if (step_push(ns, cur, alloc) & once)
+						return;
+
+					if (cur->first_child)
+						cur = cur->first_child;
+					else
+					{
+						while (!cur->next_sibling)
+						{
+							cur = cur->parent;
+
+							if (!cur) return;
+						}
+
+						cur = cur->next_sibling;
+					}
+				}
+
+				break;
+			}
+
+			case axis_preceding:
+			{
+				xml_node_struct* cur = n;
+
+				// exit from this node so that we don't include descendants
+				while (!cur->prev_sibling_c->next_sibling)
+				{
+					cur = cur->parent;
+
+					if (!cur) return;
+				}
+
+				cur = cur->prev_sibling_c;
+
+				while (cur)
+				{
+					if (cur->first_child)
+						cur = cur->first_child->prev_sibling_c;
+					else
+					{
+						// leaf node, can't be ancestor
+						if (step_push(ns, cur, alloc) & once)
+							return;
+
+						while (!cur->prev_sibling_c->next_sibling)
+						{
+							cur = cur->parent;
+
+							if (!cur) return;
+
+							if (!node_is_ancestor(cur, n))
+								if (step_push(ns, cur, alloc) & once)
+									return;
+						}
+
+						cur = cur->prev_sibling_c;
+					}
+				}
+
+				break;
+			}
+
+			case axis_ancestor:
+			case axis_ancestor_or_self:
+			{
+				if (axis == axis_ancestor_or_self)
+					if (step_push(ns, n, alloc) & once)
+						return;
+
+				xml_node_struct* cur = n->parent;
+
+				while (cur)
+				{
+					if (step_push(ns, cur, alloc) & once)
+						return;
+
+					cur = cur->parent;
+				}
+
+				break;
+			}
+
+			case axis_self:
+			{
+				step_push(ns, n, alloc);
+
+				break;
+			}
+
+			case axis_parent:
+			{
+				if (n->parent)
+					step_push(ns, n->parent, alloc);
+
+				break;
+			}
+
+			default:
+				assert(false && "Unimplemented axis"); // unreachable
+			}
+		}
+
+		template <class T> void step_fill(xpath_node_set_raw& ns, xml_attribute_struct* a, xml_node_struct* p, xpath_allocator* alloc, bool once, T v)
+		{
+			const axis_t axis = T::axis;
+
+			switch (axis)
+			{
+			case axis_ancestor:
+			case axis_ancestor_or_self:
+			{
+				if (axis == axis_ancestor_or_self && _test == nodetest_type_node) // reject attributes based on principal node type test
+					if (step_push(ns, a, p, alloc) & once)
+						return;
+
+				xml_node_struct* cur = p;
+
+				while (cur)
+				{
+					if (step_push(ns, cur, alloc) & once)
+						return;
+
+					cur = cur->parent;
+				}
+
+				break;
+			}
+
+			case axis_descendant_or_self:
+			case axis_self:
+			{
+				if (_test == nodetest_type_node) // reject attributes based on principal node type test
+					step_push(ns, a, p, alloc);
+
+				break;
+			}
+
+			case axis_following:
+			{
+				xml_node_struct* cur = p;
+
+				while (cur)
+				{
+					if (cur->first_child)
+						cur = cur->first_child;
+					else
+					{
+						while (!cur->next_sibling)
+						{
+							cur = cur->parent;
+
+							if (!cur) return;
+						}
+
+						cur = cur->next_sibling;
+					}
+
+					if (step_push(ns, cur, alloc) & once)
+						return;
+				}
+
+				break;
+			}
+
+			case axis_parent:
+			{
+				step_push(ns, p, alloc);
+
+				break;
+			}
+
+			case axis_preceding:
+			{
+				// preceding:: axis does not include attribute nodes and attribute ancestors (they are the same as parent's ancestors), so we can reuse node preceding
+				step_fill(ns, p, alloc, once, v);
+				break;
+			}
+
+			default:
+				assert(false && "Unimplemented axis"); // unreachable
+			}
+		}
+
+		template <class T> void step_fill(xpath_node_set_raw& ns, const xpath_node& xn, xpath_allocator* alloc, bool once, T v)
+		{
+			const axis_t axis = T::axis;
+			const bool axis_has_attributes = (axis == axis_ancestor || axis == axis_ancestor_or_self || axis == axis_descendant_or_self || axis == axis_following || axis == axis_parent || axis == axis_preceding || axis == axis_self);
+
+			if (xn.node())
+				step_fill(ns, xn.node().internal_object(), alloc, once, v);
+			else if (axis_has_attributes && xn.attribute() && xn.parent())
+				step_fill(ns, xn.attribute().internal_object(), xn.parent().internal_object(), alloc, once, v);
+		}
+
+		template <class T> xpath_node_set_raw step_do(const xpath_context& c, const xpath_stack& stack, nodeset_eval_t eval, T v)
+		{
+			const axis_t axis = T::axis;
+			const bool axis_reverse = (axis == axis_ancestor || axis == axis_ancestor_or_self || axis == axis_preceding || axis == axis_preceding_sibling);
+			const xpath_node_set::type_t axis_type = axis_reverse ? xpath_node_set::type_sorted_reverse : xpath_node_set::type_sorted;
+
+			bool once =
+				(axis == axis_attribute && _test == nodetest_name) ||
+				(!_right && eval_once(axis_type, eval)) ||
+			    // coverity[mixed_enums]
+				(_right && !_right->_next && _right->_test == predicate_constant_one);
+
+			xpath_node_set_raw ns;
+			ns.set_type(axis_type);
+
+			if (_left)
+			{
+				xpath_node_set_raw s = _left->eval_node_set(c, stack, nodeset_eval_all);
+
+				// self axis preserves the original order
+				if (axis == axis_self) ns.set_type(s.type());
+
+				for (const xpath_node* it = s.begin(); it != s.end(); ++it)
+				{
+					size_t size = ns.size();
+
+					// in general, all axes generate elements in a particular order, but there is no order guarantee if axis is applied to two nodes
+					if (axis != axis_self && size != 0) ns.set_type(xpath_node_set::type_unsorted);
+
+					step_fill(ns, *it, stack.result, once, v);
+					if (_right) apply_predicates(ns, size, stack, eval);
+				}
+			}
+			else
+			{
+				step_fill(ns, c.n, stack.result, once, v);
+				if (_right) apply_predicates(ns, 0, stack, eval);
+			}
+
+			// child, attribute and self axes always generate unique set of nodes
+			// for other axis, if the set stayed sorted, it stayed unique because the traversal algorithms do not visit the same node twice
+			if (axis != axis_child && axis != axis_attribute && axis != axis_self && ns.type() == xpath_node_set::type_unsorted)
+				ns.remove_duplicates(stack.temp);
+
+			return ns;
+		}
+
+	public:
+		xpath_ast_node(ast_type_t type, xpath_value_type rettype_, const char_t* value):
+			_type(static_cast<char>(type)), _rettype(static_cast<char>(rettype_)), _axis(0), _test(0), _left(0), _right(0), _next(0)
+		{
+			assert(type == ast_string_constant);
+			_data.string = value;
+		}
+
+		xpath_ast_node(ast_type_t type, xpath_value_type rettype_, double value):
+			_type(static_cast<char>(type)), _rettype(static_cast<char>(rettype_)), _axis(0), _test(0), _left(0), _right(0), _next(0)
+		{
+			assert(type == ast_number_constant);
+			_data.number = value;
+		}
+
+		xpath_ast_node(ast_type_t type, xpath_value_type rettype_, xpath_variable* value):
+			_type(static_cast<char>(type)), _rettype(static_cast<char>(rettype_)), _axis(0), _test(0), _left(0), _right(0), _next(0)
+		{
+			assert(type == ast_variable);
+			_data.variable = value;
+		}
+
+		xpath_ast_node(ast_type_t type, xpath_value_type rettype_, xpath_ast_node* left = 0, xpath_ast_node* right = 0):
+			_type(static_cast<char>(type)), _rettype(static_cast<char>(rettype_)), _axis(0), _test(0), _left(left), _right(right), _next(0)
+		{
+		}
+
+		xpath_ast_node(ast_type_t type, xpath_ast_node* left, axis_t axis, nodetest_t test, const char_t* contents):
+			_type(static_cast<char>(type)), _rettype(xpath_type_node_set), _axis(static_cast<char>(axis)), _test(static_cast<char>(test)), _left(left), _right(0), _next(0)
+		{
+			assert(type == ast_step);
+			_data.nodetest = contents;
+		}
+
+		xpath_ast_node(ast_type_t type, xpath_ast_node* left, xpath_ast_node* right, predicate_t test):
+			_type(static_cast<char>(type)), _rettype(xpath_type_node_set), _axis(0), _test(static_cast<char>(test)), _left(left), _right(right), _next(0)
+		{
+			assert(type == ast_filter || type == ast_predicate);
+		}
+
+		void set_next(xpath_ast_node* value)
+		{
+			_next = value;
+		}
+
+		void set_right(xpath_ast_node* value)
+		{
+			_right = value;
+		}
+
+		bool eval_boolean(const xpath_context& c, const xpath_stack& stack)
+		{
+			switch (_type)
+			{
+			case ast_op_or:
+				return _left->eval_boolean(c, stack) || _right->eval_boolean(c, stack);
+
+			case ast_op_and:
+				return _left->eval_boolean(c, stack) && _right->eval_boolean(c, stack);
+
+			case ast_op_equal:
+				return compare_eq(_left, _right, c, stack, equal_to());
+
+			case ast_op_not_equal:
+				return compare_eq(_left, _right, c, stack, not_equal_to());
+
+			case ast_op_less:
+				return compare_rel(_left, _right, c, stack, less());
+
+			case ast_op_greater:
+				return compare_rel(_right, _left, c, stack, less());
+
+			case ast_op_less_or_equal:
+				return compare_rel(_left, _right, c, stack, less_equal());
+
+			case ast_op_greater_or_equal:
+				return compare_rel(_right, _left, c, stack, less_equal());
+
+			case ast_func_starts_with:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_string lr = _left->eval_string(c, stack);
+				xpath_string rr = _right->eval_string(c, stack);
+
+				return starts_with(lr.c_str(), rr.c_str());
+			}
+
+			case ast_func_contains:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_string lr = _left->eval_string(c, stack);
+				xpath_string rr = _right->eval_string(c, stack);
+
+				return find_substring(lr.c_str(), rr.c_str()) != 0;
+			}
+
+			case ast_func_boolean:
+				return _left->eval_boolean(c, stack);
+
+			case ast_func_not:
+				return !_left->eval_boolean(c, stack);
+
+			case ast_func_true:
+				return true;
+
+			case ast_func_false:
+				return false;
+
+			case ast_func_lang:
+			{
+				if (c.n.attribute()) return false;
+
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_string lang = _left->eval_string(c, stack);
+
+				for (xml_node n = c.n.node(); n; n = n.parent())
+				{
+					xml_attribute a = n.attribute(PUGIXML_TEXT("xml:lang"));
+
+					if (a)
+					{
+						const char_t* value = a.value();
+
+						// strnicmp / strncasecmp is not portable
+						for (const char_t* lit = lang.c_str(); *lit; ++lit)
+						{
+							if (tolower_ascii(*lit) != tolower_ascii(*value)) return false;
+							++value;
+						}
+
+						return *value == 0 || *value == '-';
+					}
+				}
+
+				return false;
+			}
+
+			case ast_opt_compare_attribute:
+			{
+				const char_t* value = (_right->_type == ast_string_constant) ? _right->_data.string : _right->_data.variable->get_string();
+
+				xml_attribute attr = c.n.node().attribute(_left->_data.nodetest);
+
+				return attr && strequal(attr.value(), value) && is_xpath_attribute(attr.name());
+			}
+
+			case ast_variable:
+			{
+				assert(_rettype == _data.variable->type());
+
+				if (_rettype == xpath_type_boolean)
+					return _data.variable->get_boolean();
+
+				// variable needs to be converted to the correct type, this is handled by the fallthrough block below
+				break;
+			}
+
+			default:
+				;
+			}
+
+			// none of the ast types that return the value directly matched, we need to perform type conversion
+			switch (_rettype)
+			{
+			case xpath_type_number:
+				return convert_number_to_boolean(eval_number(c, stack));
+
+			case xpath_type_string:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return !eval_string(c, stack).empty();
+			}
+
+			case xpath_type_node_set:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return !eval_node_set(c, stack, nodeset_eval_any).empty();
+			}
+
+			default:
+				assert(false && "Wrong expression for return type boolean"); // unreachable
+				return false;
+			}
+		}
+
+		double eval_number(const xpath_context& c, const xpath_stack& stack)
+		{
+			switch (_type)
+			{
+			case ast_op_add:
+				return _left->eval_number(c, stack) + _right->eval_number(c, stack);
+
+			case ast_op_subtract:
+				return _left->eval_number(c, stack) - _right->eval_number(c, stack);
+
+			case ast_op_multiply:
+				return _left->eval_number(c, stack) * _right->eval_number(c, stack);
+
+			case ast_op_divide:
+				return _left->eval_number(c, stack) / _right->eval_number(c, stack);
+
+			case ast_op_mod:
+				return fmod(_left->eval_number(c, stack), _right->eval_number(c, stack));
+
+			case ast_op_negate:
+				return -_left->eval_number(c, stack);
+
+			case ast_number_constant:
+				return _data.number;
+
+			case ast_func_last:
+				return static_cast<double>(c.size);
+
+			case ast_func_position:
+				return static_cast<double>(c.position);
+
+			case ast_func_count:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return static_cast<double>(_left->eval_node_set(c, stack, nodeset_eval_all).size());
+			}
+
+			case ast_func_string_length_0:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return static_cast<double>(string_value(c.n, stack.result).length());
+			}
+
+			case ast_func_string_length_1:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return static_cast<double>(_left->eval_string(c, stack).length());
+			}
+
+			case ast_func_number_0:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return convert_string_to_number(string_value(c.n, stack.result).c_str());
+			}
+
+			case ast_func_number_1:
+				return _left->eval_number(c, stack);
+
+			case ast_func_sum:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				double r = 0;
+
+				xpath_node_set_raw ns = _left->eval_node_set(c, stack, nodeset_eval_all);
+
+				for (const xpath_node* it = ns.begin(); it != ns.end(); ++it)
+				{
+					xpath_allocator_capture cri(stack.result);
+
+					r += convert_string_to_number(string_value(*it, stack.result).c_str());
+				}
+
+				return r;
+			}
+
+			case ast_func_floor:
+			{
+				double r = _left->eval_number(c, stack);
+
+				return r == r ? floor(r) : r;
+			}
+
+			case ast_func_ceiling:
+			{
+				double r = _left->eval_number(c, stack);
+
+				return r == r ? ceil(r) : r;
+			}
+
+			case ast_func_round:
+				return round_nearest_nzero(_left->eval_number(c, stack));
+
+			case ast_variable:
+			{
+				assert(_rettype == _data.variable->type());
+
+				if (_rettype == xpath_type_number)
+					return _data.variable->get_number();
+
+				// variable needs to be converted to the correct type, this is handled by the fallthrough block below
+				break;
+			}
+
+			default:
+				;
+			}
+
+			// none of the ast types that return the value directly matched, we need to perform type conversion
+			switch (_rettype)
+			{
+			case xpath_type_boolean:
+				return eval_boolean(c, stack) ? 1 : 0;
+
+			case xpath_type_string:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return convert_string_to_number(eval_string(c, stack).c_str());
+			}
+
+			case xpath_type_node_set:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				return convert_string_to_number(eval_string(c, stack).c_str());
+			}
+
+			default:
+				assert(false && "Wrong expression for return type number"); // unreachable
+				return 0;
+			}
+		}
+
+		xpath_string eval_string_concat(const xpath_context& c, const xpath_stack& stack)
+		{
+			assert(_type == ast_func_concat);
+
+			xpath_allocator_capture ct(stack.temp);
+
+			// count the string number
+			size_t count = 1;
+			for (xpath_ast_node* nc = _right; nc; nc = nc->_next) count++;
+
+			// allocate a buffer for temporary string objects
+			xpath_string* buffer = static_cast<xpath_string*>(stack.temp->allocate(count * sizeof(xpath_string)));
+			if (!buffer) return xpath_string();
+
+			// evaluate all strings to temporary stack
+			xpath_stack swapped_stack = {stack.temp, stack.result};
+
+			buffer[0] = _left->eval_string(c, swapped_stack);
+
+			size_t pos = 1;
+			for (xpath_ast_node* n = _right; n; n = n->_next, ++pos) buffer[pos] = n->eval_string(c, swapped_stack);
+			assert(pos == count);
+
+			// get total length
+			size_t length = 0;
+			for (size_t i = 0; i < count; ++i) length += buffer[i].length();
+
+			// create final string
+			char_t* result = static_cast<char_t*>(stack.result->allocate((length + 1) * sizeof(char_t)));
+			if (!result) return xpath_string();
+
+			char_t* ri = result;
+
+			for (size_t j = 0; j < count; ++j)
+				for (const char_t* bi = buffer[j].c_str(); *bi; ++bi)
+					*ri++ = *bi;
+
+			*ri = 0;
+
+			return xpath_string::from_heap_preallocated(result, ri);
+		}
+
+		xpath_string eval_string(const xpath_context& c, const xpath_stack& stack)
+		{
+			switch (_type)
+			{
+			case ast_string_constant:
+				return xpath_string::from_const(_data.string);
+
+			case ast_func_local_name_0:
+			{
+				xpath_node na = c.n;
+
+				return xpath_string::from_const(local_name(na));
+			}
+
+			case ast_func_local_name_1:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ns = _left->eval_node_set(c, stack, nodeset_eval_first);
+				xpath_node na = ns.first();
+
+				return xpath_string::from_const(local_name(na));
+			}
+
+			case ast_func_name_0:
+			{
+				xpath_node na = c.n;
+
+				return xpath_string::from_const(qualified_name(na));
+			}
+
+			case ast_func_name_1:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ns = _left->eval_node_set(c, stack, nodeset_eval_first);
+				xpath_node na = ns.first();
+
+				return xpath_string::from_const(qualified_name(na));
+			}
+
+			case ast_func_namespace_uri_0:
+			{
+				xpath_node na = c.n;
+
+				return xpath_string::from_const(namespace_uri(na));
+			}
+
+			case ast_func_namespace_uri_1:
+			{
+				xpath_allocator_capture cr(stack.result);
+
+				xpath_node_set_raw ns = _left->eval_node_set(c, stack, nodeset_eval_first);
+				xpath_node na = ns.first();
+
+				return xpath_string::from_const(namespace_uri(na));
+			}
+
+			case ast_func_string_0:
+				return string_value(c.n, stack.result);
+
+			case ast_func_string_1:
+				return _left->eval_string(c, stack);
+
+			case ast_func_concat:
+				return eval_string_concat(c, stack);
+
+			case ast_func_substring_before:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_string s = _left->eval_string(c, swapped_stack);
+				xpath_string p = _right->eval_string(c, swapped_stack);
+
+				const char_t* pos = find_substring(s.c_str(), p.c_str());
+
+				return pos ? xpath_string::from_heap(s.c_str(), pos, stack.result) : xpath_string();
+			}
+
+			case ast_func_substring_after:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_string s = _left->eval_string(c, swapped_stack);
+				xpath_string p = _right->eval_string(c, swapped_stack);
+
+				const char_t* pos = find_substring(s.c_str(), p.c_str());
+				if (!pos) return xpath_string();
+
+				const char_t* rbegin = pos + p.length();
+				const char_t* rend = s.c_str() + s.length();
+
+				return s.uses_heap() ? xpath_string::from_heap(rbegin, rend, stack.result) : xpath_string::from_const(rbegin);
+			}
+
+			case ast_func_substring_2:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_string s = _left->eval_string(c, swapped_stack);
+				size_t s_length = s.length();
+
+				double first = round_nearest(_right->eval_number(c, stack));
+
+				if (is_nan(first)) return xpath_string(); // NaN
+				else if (first >= static_cast<double>(s_length + 1)) return xpath_string();
+
+				size_t pos = first < 1 ? 1 : static_cast<size_t>(first);
+				assert(1 <= pos && pos <= s_length + 1);
+
+				const char_t* rbegin = s.c_str() + (pos - 1);
+				const char_t* rend = s.c_str() + s.length();
+
+				return s.uses_heap() ? xpath_string::from_heap(rbegin, rend, stack.result) : xpath_string::from_const(rbegin);
+			}
+
+			case ast_func_substring_3:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_string s = _left->eval_string(c, swapped_stack);
+				size_t s_length = s.length();
+
+				double first = round_nearest(_right->eval_number(c, stack));
+				double last = first + round_nearest(_right->_next->eval_number(c, stack));
+
+				if (is_nan(first) || is_nan(last)) return xpath_string();
+				else if (first >= static_cast<double>(s_length + 1)) return xpath_string();
+				else if (first >= last) return xpath_string();
+				else if (last < 1) return xpath_string();
+
+				size_t pos = first < 1 ? 1 : static_cast<size_t>(first);
+				size_t end = last >= static_cast<double>(s_length + 1) ? s_length + 1 : static_cast<size_t>(last);
+
+				assert(1 <= pos && pos <= end && end <= s_length + 1);
+				const char_t* rbegin = s.c_str() + (pos - 1);
+				const char_t* rend = s.c_str() + (end - 1);
+
+				return (end == s_length + 1 && !s.uses_heap()) ? xpath_string::from_const(rbegin) : xpath_string::from_heap(rbegin, rend, stack.result);
+			}
+
+			case ast_func_normalize_space_0:
+			{
+				xpath_string s = string_value(c.n, stack.result);
+
+				char_t* begin = s.data(stack.result);
+				if (!begin) return xpath_string();
+
+				char_t* end = normalize_space(begin);
+
+				return xpath_string::from_heap_preallocated(begin, end);
+			}
+
+			case ast_func_normalize_space_1:
+			{
+				xpath_string s = _left->eval_string(c, stack);
+
+				char_t* begin = s.data(stack.result);
+				if (!begin) return xpath_string();
+
+				char_t* end = normalize_space(begin);
+
+				return xpath_string::from_heap_preallocated(begin, end);
+			}
+
+			case ast_func_translate:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_string s = _left->eval_string(c, stack);
+				xpath_string from = _right->eval_string(c, swapped_stack);
+				xpath_string to = _right->_next->eval_string(c, swapped_stack);
+
+				char_t* begin = s.data(stack.result);
+				if (!begin) return xpath_string();
+
+				char_t* end = translate(begin, from.c_str(), to.c_str(), to.length());
+
+				return xpath_string::from_heap_preallocated(begin, end);
+			}
+
+			case ast_opt_translate_table:
+			{
+				xpath_string s = _left->eval_string(c, stack);
+
+				char_t* begin = s.data(stack.result);
+				if (!begin) return xpath_string();
+
+				char_t* end = translate_table(begin, _data.table);
+
+				return xpath_string::from_heap_preallocated(begin, end);
+			}
+
+			case ast_variable:
+			{
+				assert(_rettype == _data.variable->type());
+
+				if (_rettype == xpath_type_string)
+					return xpath_string::from_const(_data.variable->get_string());
+
+				// variable needs to be converted to the correct type, this is handled by the fallthrough block below
+				break;
+			}
+
+			default:
+				;
+			}
+
+			// none of the ast types that return the value directly matched, we need to perform type conversion
+			switch (_rettype)
+			{
+			case xpath_type_boolean:
+				return xpath_string::from_const(eval_boolean(c, stack) ? PUGIXML_TEXT("true") : PUGIXML_TEXT("false"));
+
+			case xpath_type_number:
+				return convert_number_to_string(eval_number(c, stack), stack.result);
+
+			case xpath_type_node_set:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_node_set_raw ns = eval_node_set(c, swapped_stack, nodeset_eval_first);
+				return ns.empty() ? xpath_string() : string_value(ns.first(), stack.result);
+			}
+
+			default:
+				assert(false && "Wrong expression for return type string"); // unreachable
+				return xpath_string();
+			}
+		}
+
+		xpath_node_set_raw eval_node_set(const xpath_context& c, const xpath_stack& stack, nodeset_eval_t eval)
+		{
+			switch (_type)
+			{
+			case ast_op_union:
+			{
+				xpath_allocator_capture cr(stack.temp);
+
+				xpath_stack swapped_stack = {stack.temp, stack.result};
+
+				xpath_node_set_raw ls = _left->eval_node_set(c, stack, eval);
+				xpath_node_set_raw rs = _right->eval_node_set(c, swapped_stack, eval);
+
+				// we can optimize merging two sorted sets, but this is a very rare operation, so don't bother
+				ls.set_type(xpath_node_set::type_unsorted);
+
+				ls.append(rs.begin(), rs.end(), stack.result);
+				ls.remove_duplicates(stack.temp);
+
+				return ls;
+			}
+
+			case ast_filter:
+			{
+				xpath_node_set_raw set = _left->eval_node_set(c, stack, _test == predicate_constant_one ? nodeset_eval_first : nodeset_eval_all);
+
+				// either expression is a number or it contains position() call; sort by document order
+				if (_test != predicate_posinv) set.sort_do();
+
+				bool once = eval_once(set.type(), eval);
+
+				apply_predicate(set, 0, stack, once);
+
+				return set;
+			}
+
+			case ast_func_id:
+				return xpath_node_set_raw();
+
+			case ast_step:
+			{
+				switch (_axis)
+				{
+				case axis_ancestor:
+					return step_do(c, stack, eval, axis_to_type<axis_ancestor>());
+
+				case axis_ancestor_or_self:
+					return step_do(c, stack, eval, axis_to_type<axis_ancestor_or_self>());
+
+				case axis_attribute:
+					return step_do(c, stack, eval, axis_to_type<axis_attribute>());
+
+				case axis_child:
+					return step_do(c, stack, eval, axis_to_type<axis_child>());
+
+				case axis_descendant:
+					return step_do(c, stack, eval, axis_to_type<axis_descendant>());
+
+				case axis_descendant_or_self:
+					return step_do(c, stack, eval, axis_to_type<axis_descendant_or_self>());
+
+				case axis_following:
+					return step_do(c, stack, eval, axis_to_type<axis_following>());
+
+				case axis_following_sibling:
+					return step_do(c, stack, eval, axis_to_type<axis_following_sibling>());
+
+				case axis_namespace:
+					// namespaced axis is not supported
+					return xpath_node_set_raw();
+
+				case axis_parent:
+					return step_do(c, stack, eval, axis_to_type<axis_parent>());
+
+				case axis_preceding:
+					return step_do(c, stack, eval, axis_to_type<axis_preceding>());
+
+				case axis_preceding_sibling:
+					return step_do(c, stack, eval, axis_to_type<axis_preceding_sibling>());
+
+				case axis_self:
+					return step_do(c, stack, eval, axis_to_type<axis_self>());
+
+				default:
+					assert(false && "Unknown axis"); // unreachable
+					return xpath_node_set_raw();
+				}
+			}
+
+			case ast_step_root:
+			{
+				assert(!_right); // root step can't have any predicates
+
+				xpath_node_set_raw ns;
+
+				ns.set_type(xpath_node_set::type_sorted);
+
+				if (c.n.node()) ns.push_back(c.n.node().root(), stack.result);
+				else if (c.n.attribute()) ns.push_back(c.n.parent().root(), stack.result);
+
+				return ns;
+			}
+
+			case ast_variable:
+			{
+				assert(_rettype == _data.variable->type());
+
+				if (_rettype == xpath_type_node_set)
+				{
+					const xpath_node_set& s = _data.variable->get_node_set();
+
+					xpath_node_set_raw ns;
+
+					ns.set_type(s.type());
+					ns.append(s.begin(), s.end(), stack.result);
+
+					return ns;
+				}
+
+				// variable needs to be converted to the correct type, this is handled by the fallthrough block below
+				break;
+			}
+
+			default:
+				;
+			}
+
+			// none of the ast types that return the value directly matched, but conversions to node set are invalid
+			assert(false && "Wrong expression for return type node set"); // unreachable
+			return xpath_node_set_raw();
+		}
+
+		void optimize(xpath_allocator* alloc)
+		{
+			if (_left)
+				_left->optimize(alloc);
+
+			if (_right)
+				_right->optimize(alloc);
+
+			if (_next)
+				_next->optimize(alloc);
+
+			// coverity[var_deref_model]
+			optimize_self(alloc);
+		}
+
+		void optimize_self(xpath_allocator* alloc)
+		{
+			// Rewrite [position()=expr] with [expr]
+			// Note that this step has to go before classification to recognize [position()=1]
+			if ((_type == ast_filter || _type == ast_predicate) &&
+				_right && // workaround for clang static analyzer (_right is never null for ast_filter/ast_predicate)
+				_right->_type == ast_op_equal && _right->_left->_type == ast_func_position && _right->_right->_rettype == xpath_type_number)
+			{
+				_right = _right->_right;
+			}
+
+			// Classify filter/predicate ops to perform various optimizations during evaluation
+			if ((_type == ast_filter || _type == ast_predicate) && _right) // workaround for clang static analyzer (_right is never null for ast_filter/ast_predicate)
+			{
+				assert(_test == predicate_default);
+
+				if (_right->_type == ast_number_constant && _right->_data.number == 1.0)
+					_test = predicate_constant_one;
+				else if (_right->_rettype == xpath_type_number && (_right->_type == ast_number_constant || _right->_type == ast_variable || _right->_type == ast_func_last))
+					_test = predicate_constant;
+				else if (_right->_rettype != xpath_type_number && _right->is_posinv_expr())
+					_test = predicate_posinv;
+			}
+
+			// Rewrite descendant-or-self::node()/child::foo with descendant::foo
+			// The former is a full form of //foo, the latter is much faster since it executes the node test immediately
+			// Do a similar kind of rewrite for self/descendant/descendant-or-self axes
+			// Note that we only rewrite positionally invariant steps (//foo[1] != /descendant::foo[1])
+			if (_type == ast_step && (_axis == axis_child || _axis == axis_self || _axis == axis_descendant || _axis == axis_descendant_or_self) &&
+				_left && _left->_type == ast_step && _left->_axis == axis_descendant_or_self && _left->_test == nodetest_type_node && !_left->_right &&
+				is_posinv_step())
+			{
+				if (_axis == axis_child || _axis == axis_descendant)
+					_axis = axis_descendant;
+				else
+					_axis = axis_descendant_or_self;
+
+				_left = _left->_left;
+			}
+
+			// Use optimized lookup table implementation for translate() with constant arguments
+			if (_type == ast_func_translate &&
+				_right && // workaround for clang static analyzer (_right is never null for ast_func_translate)
+				_right->_type == ast_string_constant && _right->_next->_type == ast_string_constant)
+			{
+				unsigned char* table = translate_table_generate(alloc, _right->_data.string, _right->_next->_data.string);
+
+				if (table)
+				{
+					_type = ast_opt_translate_table;
+					_data.table = table;
+				}
+			}
+
+			// Use optimized path for @attr = 'value' or @attr = $value
+			if (_type == ast_op_equal &&
+				_left && _right && // workaround for clang static analyzer and Coverity (_left and _right are never null for ast_op_equal)
+                // coverity[mixed_enums]
+				_left->_type == ast_step && _left->_axis == axis_attribute && _left->_test == nodetest_name && !_left->_left && !_left->_right &&
+				(_right->_type == ast_string_constant || (_right->_type == ast_variable && _right->_rettype == xpath_type_string)))
+			{
+				_type = ast_opt_compare_attribute;
+			}
+		}
+
+		bool is_posinv_expr() const
+		{
+			switch (_type)
+			{
+			case ast_func_position:
+			case ast_func_last:
+				return false;
+
+			case ast_string_constant:
+			case ast_number_constant:
+			case ast_variable:
+				return true;
+
+			case ast_step:
+			case ast_step_root:
+				return true;
+
+			case ast_predicate:
+			case ast_filter:
+				return true;
+
+			default:
+				if (_left && !_left->is_posinv_expr()) return false;
+
+				for (xpath_ast_node* n = _right; n; n = n->_next)
+					if (!n->is_posinv_expr()) return false;
+
+				return true;
+			}
+		}
+
+		bool is_posinv_step() const
+		{
+			assert(_type == ast_step);
+
+			for (xpath_ast_node* n = _right; n; n = n->_next)
+			{
+				assert(n->_type == ast_predicate);
+
+				if (n->_test != predicate_posinv)
+					return false;
+			}
+
+			return true;
+		}
+
+		xpath_value_type rettype() const
+		{
+			return static_cast<xpath_value_type>(_rettype);
+		}
+	};
+
+	static const size_t xpath_ast_depth_limit =
+	#ifdef PUGIXML_XPATH_DEPTH_LIMIT
+		PUGIXML_XPATH_DEPTH_LIMIT
+	#else
+		1024
+	#endif
+		;
+
+	struct xpath_parser
+	{
+		xpath_allocator* _alloc;
+		xpath_lexer _lexer;
+
+		const char_t* _query;
+		xpath_variable_set* _variables;
+
+		xpath_parse_result* _result;
+
+		char_t _scratch[32];
+
+		size_t _depth;
+
+		xpath_ast_node* error(const char* message)
+		{
+			_result->error = message;
+			_result->offset = _lexer.current_pos() - _query;
+
+			return 0;
+		}
+
+		xpath_ast_node* error_oom()
+		{
+			assert(_alloc->_error);
+			*_alloc->_error = true;
+
+			return 0;
+		}
+
+		xpath_ast_node* error_rec()
+		{
+			return error("Exceeded maximum allowed query depth");
+		}
+
+		void* alloc_node()
+		{
+			return _alloc->allocate(sizeof(xpath_ast_node));
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_value_type rettype, const char_t* value)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, rettype, value) : 0;
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_value_type rettype, double value)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, rettype, value) : 0;
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_value_type rettype, xpath_variable* value)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, rettype, value) : 0;
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_value_type rettype, xpath_ast_node* left = 0, xpath_ast_node* right = 0)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, rettype, left, right) : 0;
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_ast_node* left, axis_t axis, nodetest_t test, const char_t* contents)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, left, axis, test, contents) : 0;
+		}
+
+		xpath_ast_node* alloc_node(ast_type_t type, xpath_ast_node* left, xpath_ast_node* right, predicate_t test)
+		{
+			void* memory = alloc_node();
+			return memory ? new (memory) xpath_ast_node(type, left, right, test) : 0;
+		}
+
+		const char_t* alloc_string(const xpath_lexer_string& value)
+		{
+			if (!value.begin)
+				return PUGIXML_TEXT("");
+
+			size_t length = static_cast<size_t>(value.end - value.begin);
+
+			char_t* c = static_cast<char_t*>(_alloc->allocate((length + 1) * sizeof(char_t)));
+			if (!c) return 0;
+
+			memcpy(c, value.begin, length * sizeof(char_t));
+			c[length] = 0;
+
+			return c;
+		}
+
+		xpath_ast_node* parse_function(const xpath_lexer_string& name, size_t argc, xpath_ast_node* args[2])
+		{
+			switch (name.begin[0])
+			{
+			case 'b':
+				if (name == PUGIXML_TEXT("boolean") && argc == 1)
+					return alloc_node(ast_func_boolean, xpath_type_boolean, args[0]);
+
+				break;
+
+			case 'c':
+				if (name == PUGIXML_TEXT("count") && argc == 1)
+				{
+					if (args[0]->rettype() != xpath_type_node_set) return error("Function has to be applied to node set");
+					return alloc_node(ast_func_count, xpath_type_number, args[0]);
+				}
+				else if (name == PUGIXML_TEXT("contains") && argc == 2)
+					return alloc_node(ast_func_contains, xpath_type_boolean, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("concat") && argc >= 2)
+					return alloc_node(ast_func_concat, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("ceiling") && argc == 1)
+					return alloc_node(ast_func_ceiling, xpath_type_number, args[0]);
+
+				break;
+
+			case 'f':
+				if (name == PUGIXML_TEXT("false") && argc == 0)
+					return alloc_node(ast_func_false, xpath_type_boolean);
+				else if (name == PUGIXML_TEXT("floor") && argc == 1)
+					return alloc_node(ast_func_floor, xpath_type_number, args[0]);
+
+				break;
+
+			case 'i':
+				if (name == PUGIXML_TEXT("id") && argc == 1)
+					return alloc_node(ast_func_id, xpath_type_node_set, args[0]);
+
+				break;
+
+			case 'l':
+				if (name == PUGIXML_TEXT("last") && argc == 0)
+					return alloc_node(ast_func_last, xpath_type_number);
+				else if (name == PUGIXML_TEXT("lang") && argc == 1)
+					return alloc_node(ast_func_lang, xpath_type_boolean, args[0]);
+				else if (name == PUGIXML_TEXT("local-name") && argc <= 1)
+				{
+					if (argc == 1 && args[0]->rettype() != xpath_type_node_set) return error("Function has to be applied to node set");
+					return alloc_node(argc == 0 ? ast_func_local_name_0 : ast_func_local_name_1, xpath_type_string, args[0]);
+				}
+
+				break;
+
+			case 'n':
+				if (name == PUGIXML_TEXT("name") && argc <= 1)
+				{
+					if (argc == 1 && args[0]->rettype() != xpath_type_node_set) return error("Function has to be applied to node set");
+					return alloc_node(argc == 0 ? ast_func_name_0 : ast_func_name_1, xpath_type_string, args[0]);
+				}
+				else if (name == PUGIXML_TEXT("namespace-uri") && argc <= 1)
+				{
+					if (argc == 1 && args[0]->rettype() != xpath_type_node_set) return error("Function has to be applied to node set");
+					return alloc_node(argc == 0 ? ast_func_namespace_uri_0 : ast_func_namespace_uri_1, xpath_type_string, args[0]);
+				}
+				else if (name == PUGIXML_TEXT("normalize-space") && argc <= 1)
+					return alloc_node(argc == 0 ? ast_func_normalize_space_0 : ast_func_normalize_space_1, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("not") && argc == 1)
+					return alloc_node(ast_func_not, xpath_type_boolean, args[0]);
+				else if (name == PUGIXML_TEXT("number") && argc <= 1)
+					return alloc_node(argc == 0 ? ast_func_number_0 : ast_func_number_1, xpath_type_number, args[0]);
+
+				break;
+
+			case 'p':
+				if (name == PUGIXML_TEXT("position") && argc == 0)
+					return alloc_node(ast_func_position, xpath_type_number);
+
+				break;
+
+			case 'r':
+				if (name == PUGIXML_TEXT("round") && argc == 1)
+					return alloc_node(ast_func_round, xpath_type_number, args[0]);
+
+				break;
+
+			case 's':
+				if (name == PUGIXML_TEXT("string") && argc <= 1)
+					return alloc_node(argc == 0 ? ast_func_string_0 : ast_func_string_1, xpath_type_string, args[0]);
+				else if (name == PUGIXML_TEXT("string-length") && argc <= 1)
+					return alloc_node(argc == 0 ? ast_func_string_length_0 : ast_func_string_length_1, xpath_type_number, args[0]);
+				else if (name == PUGIXML_TEXT("starts-with") && argc == 2)
+					return alloc_node(ast_func_starts_with, xpath_type_boolean, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("substring-before") && argc == 2)
+					return alloc_node(ast_func_substring_before, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("substring-after") && argc == 2)
+					return alloc_node(ast_func_substring_after, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("substring") && (argc == 2 || argc == 3))
+					return alloc_node(argc == 2 ? ast_func_substring_2 : ast_func_substring_3, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("sum") && argc == 1)
+				{
+					if (args[0]->rettype() != xpath_type_node_set) return error("Function has to be applied to node set");
+					return alloc_node(ast_func_sum, xpath_type_number, args[0]);
+				}
+
+				break;
+
+			case 't':
+				if (name == PUGIXML_TEXT("translate") && argc == 3)
+					return alloc_node(ast_func_translate, xpath_type_string, args[0], args[1]);
+				else if (name == PUGIXML_TEXT("true") && argc == 0)
+					return alloc_node(ast_func_true, xpath_type_boolean);
+
+				break;
+
+			default:
+				break;
+			}
+
+			return error("Unrecognized function or wrong parameter count");
+		}
+
+		axis_t parse_axis_name(const xpath_lexer_string& name, bool& specified)
+		{
+			specified = true;
+
+			switch (name.begin[0])
+			{
+			case 'a':
+				if (name == PUGIXML_TEXT("ancestor"))
+					return axis_ancestor;
+				else if (name == PUGIXML_TEXT("ancestor-or-self"))
+					return axis_ancestor_or_self;
+				else if (name == PUGIXML_TEXT("attribute"))
+					return axis_attribute;
+
+				break;
+
+			case 'c':
+				if (name == PUGIXML_TEXT("child"))
+					return axis_child;
+
+				break;
+
+			case 'd':
+				if (name == PUGIXML_TEXT("descendant"))
+					return axis_descendant;
+				else if (name == PUGIXML_TEXT("descendant-or-self"))
+					return axis_descendant_or_self;
+
+				break;
+
+			case 'f':
+				if (name == PUGIXML_TEXT("following"))
+					return axis_following;
+				else if (name == PUGIXML_TEXT("following-sibling"))
+					return axis_following_sibling;
+
+				break;
+
+			case 'n':
+				if (name == PUGIXML_TEXT("namespace"))
+					return axis_namespace;
+
+				break;
+
+			case 'p':
+				if (name == PUGIXML_TEXT("parent"))
+					return axis_parent;
+				else if (name == PUGIXML_TEXT("preceding"))
+					return axis_preceding;
+				else if (name == PUGIXML_TEXT("preceding-sibling"))
+					return axis_preceding_sibling;
+
+				break;
+
+			case 's':
+				if (name == PUGIXML_TEXT("self"))
+					return axis_self;
+
+				break;
+
+			default:
+				break;
+			}
+
+			specified = false;
+			return axis_child;
+		}
+
+		nodetest_t parse_node_test_type(const xpath_lexer_string& name)
+		{
+			switch (name.begin[0])
+			{
+			case 'c':
+				if (name == PUGIXML_TEXT("comment"))
+					return nodetest_type_comment;
+
+				break;
+
+			case 'n':
+				if (name == PUGIXML_TEXT("node"))
+					return nodetest_type_node;
+
+				break;
+
+			case 'p':
+				if (name == PUGIXML_TEXT("processing-instruction"))
+					return nodetest_type_pi;
+
+				break;
+
+			case 't':
+				if (name == PUGIXML_TEXT("text"))
+					return nodetest_type_text;
+
+				break;
+
+			default:
+				break;
+			}
+
+			return nodetest_none;
+		}
+
+		// PrimaryExpr ::= VariableReference | '(' Expr ')' | Literal | Number | FunctionCall
+		xpath_ast_node* parse_primary_expression()
+		{
+			switch (_lexer.current())
+			{
+			case lex_var_ref:
+			{
+				xpath_lexer_string name = _lexer.contents();
+
+				if (!_variables)
+					return error("Unknown variable: variable set is not provided");
+
+				xpath_variable* var = 0;
+				if (!get_variable_scratch(_scratch, _variables, name.begin, name.end, &var))
+					return error_oom();
+
+				if (!var)
+					return error("Unknown variable: variable set does not contain the given name");
+
+				_lexer.next();
+
+				return alloc_node(ast_variable, var->type(), var);
+			}
+
+			case lex_open_brace:
+			{
+				_lexer.next();
+
+				xpath_ast_node* n = parse_expression();
+				if (!n) return 0;
+
+				if (_lexer.current() != lex_close_brace)
+					return error("Expected ')' to match an opening '('");
+
+				_lexer.next();
+
+				return n;
+			}
+
+			case lex_quoted_string:
+			{
+				const char_t* value = alloc_string(_lexer.contents());
+				if (!value) return 0;
+
+				_lexer.next();
+
+				return alloc_node(ast_string_constant, xpath_type_string, value);
+			}
+
+			case lex_number:
+			{
+				double value = 0;
+
+				if (!convert_string_to_number_scratch(_scratch, _lexer.contents().begin, _lexer.contents().end, &value))
+					return error_oom();
+
+				_lexer.next();
+
+				return alloc_node(ast_number_constant, xpath_type_number, value);
+			}
+
+			case lex_string:
+			{
+				xpath_ast_node* args[2] = {0};
+				size_t argc = 0;
+
+				xpath_lexer_string function = _lexer.contents();
+				_lexer.next();
+
+				xpath_ast_node* last_arg = 0;
+
+				if (_lexer.current() != lex_open_brace)
+					return error("Unrecognized function call");
+				_lexer.next();
+
+				size_t old_depth = _depth;
+
+				while (_lexer.current() != lex_close_brace)
+				{
+					if (argc > 0)
+					{
+						if (_lexer.current() != lex_comma)
+							return error("No comma between function arguments");
+						_lexer.next();
+					}
+
+					if (++_depth > xpath_ast_depth_limit)
+						return error_rec();
+
+					xpath_ast_node* n = parse_expression();
+					if (!n) return 0;
+
+					if (argc < 2) args[argc] = n;
+					else last_arg->set_next(n);
+
+					argc++;
+					last_arg = n;
+				}
+
+				_lexer.next();
+
+				_depth = old_depth;
+
+				return parse_function(function, argc, args);
+			}
+
+			default:
+				return error("Unrecognizable primary expression");
+			}
+		}
+
+		// FilterExpr ::= PrimaryExpr | FilterExpr Predicate
+		// Predicate ::= '[' PredicateExpr ']'
+		// PredicateExpr ::= Expr
+		xpath_ast_node* parse_filter_expression()
+		{
+			xpath_ast_node* n = parse_primary_expression();
+			if (!n) return 0;
+
+			size_t old_depth = _depth;
+
+			while (_lexer.current() == lex_open_square_brace)
+			{
+				_lexer.next();
+
+				if (++_depth > xpath_ast_depth_limit)
+					return error_rec();
+
+				if (n->rettype() != xpath_type_node_set)
+					return error("Predicate has to be applied to node set");
+
+				xpath_ast_node* expr = parse_expression();
+				if (!expr) return 0;
+
+				n = alloc_node(ast_filter, n, expr, predicate_default);
+				if (!n) return 0;
+
+				if (_lexer.current() != lex_close_square_brace)
+					return error("Expected ']' to match an opening '['");
+
+				_lexer.next();
+			}
+
+			_depth = old_depth;
+
+			return n;
+		}
+
+		// Step ::= AxisSpecifier NodeTest Predicate* | AbbreviatedStep
+		// AxisSpecifier ::= AxisName '::' | '@'?
+		// NodeTest ::= NameTest | NodeType '(' ')' | 'processing-instruction' '(' Literal ')'
+		// NameTest ::= '*' | NCName ':' '*' | QName
+		// AbbreviatedStep ::= '.' | '..'
+		xpath_ast_node* parse_step(xpath_ast_node* set)
+		{
+			if (set && set->rettype() != xpath_type_node_set)
+				return error("Step has to be applied to node set");
+
+			bool axis_specified = false;
+			axis_t axis = axis_child; // implied child axis
+
+			if (_lexer.current() == lex_axis_attribute)
+			{
+				axis = axis_attribute;
+				axis_specified = true;
+
+				_lexer.next();
+			}
+			else if (_lexer.current() == lex_dot)
+			{
+				_lexer.next();
+
+				if (_lexer.current() == lex_open_square_brace)
+					return error("Predicates are not allowed after an abbreviated step");
+
+				return alloc_node(ast_step, set, axis_self, nodetest_type_node, 0);
+			}
+			else if (_lexer.current() == lex_double_dot)
+			{
+				_lexer.next();
+
+				if (_lexer.current() == lex_open_square_brace)
+					return error("Predicates are not allowed after an abbreviated step");
+
+				return alloc_node(ast_step, set, axis_parent, nodetest_type_node, 0);
+			}
+
+			nodetest_t nt_type = nodetest_none;
+			xpath_lexer_string nt_name;
+
+			if (_lexer.current() == lex_string)
+			{
+				// node name test
+				nt_name = _lexer.contents();
+				_lexer.next();
+
+				// was it an axis name?
+				if (_lexer.current() == lex_double_colon)
+				{
+					// parse axis name
+					if (axis_specified)
+						return error("Two axis specifiers in one step");
+
+					axis = parse_axis_name(nt_name, axis_specified);
+
+					if (!axis_specified)
+						return error("Unknown axis");
+
+					// read actual node test
+					_lexer.next();
+
+					if (_lexer.current() == lex_multiply)
+					{
+						nt_type = nodetest_all;
+						nt_name = xpath_lexer_string();
+						_lexer.next();
+					}
+					else if (_lexer.current() == lex_string)
+					{
+						nt_name = _lexer.contents();
+						_lexer.next();
+					}
+					else
+					{
+						return error("Unrecognized node test");
+					}
+				}
+
+				if (nt_type == nodetest_none)
+				{
+					// node type test or processing-instruction
+					if (_lexer.current() == lex_open_brace)
+					{
+						_lexer.next();
+
+						if (_lexer.current() == lex_close_brace)
+						{
+							_lexer.next();
+
+							nt_type = parse_node_test_type(nt_name);
+
+							if (nt_type == nodetest_none)
+								return error("Unrecognized node type");
+
+							nt_name = xpath_lexer_string();
+						}
+						else if (nt_name == PUGIXML_TEXT("processing-instruction"))
+						{
+							if (_lexer.current() != lex_quoted_string)
+								return error("Only literals are allowed as arguments to processing-instruction()");
+
+							nt_type = nodetest_pi;
+							nt_name = _lexer.contents();
+							_lexer.next();
+
+							if (_lexer.current() != lex_close_brace)
+								return error("Unmatched brace near processing-instruction()");
+							_lexer.next();
+						}
+						else
+						{
+							return error("Unmatched brace near node type test");
+						}
+					}
+					// QName or NCName:*
+					else
+					{
+						if (nt_name.end - nt_name.begin > 2 && nt_name.end[-2] == ':' && nt_name.end[-1] == '*') // NCName:*
+						{
+							nt_name.end--; // erase *
+
+							nt_type = nodetest_all_in_namespace;
+						}
+						else
+						{
+							nt_type = nodetest_name;
+						}
+					}
+				}
+			}
+			else if (_lexer.current() == lex_multiply)
+			{
+				nt_type = nodetest_all;
+				_lexer.next();
+			}
+			else
+			{
+				return error("Unrecognized node test");
+			}
+
+			const char_t* nt_name_copy = alloc_string(nt_name);
+			if (!nt_name_copy) return 0;
+
+			xpath_ast_node* n = alloc_node(ast_step, set, axis, nt_type, nt_name_copy);
+			if (!n) return 0;
+
+			size_t old_depth = _depth;
+
+			xpath_ast_node* last = 0;
+
+			while (_lexer.current() == lex_open_square_brace)
+			{
+				_lexer.next();
+
+				if (++_depth > xpath_ast_depth_limit)
+					return error_rec();
+
+				xpath_ast_node* expr = parse_expression();
+				if (!expr) return 0;
+
+				xpath_ast_node* pred = alloc_node(ast_predicate, 0, expr, predicate_default);
+				if (!pred) return 0;
+
+				if (_lexer.current() != lex_close_square_brace)
+					return error("Expected ']' to match an opening '['");
+				_lexer.next();
+
+				if (last) last->set_next(pred);
+				else n->set_right(pred);
+
+				last = pred;
+			}
+
+			_depth = old_depth;
+
+			return n;
+		}
+
+		// RelativeLocationPath ::= Step | RelativeLocationPath '/' Step | RelativeLocationPath '//' Step
+		xpath_ast_node* parse_relative_location_path(xpath_ast_node* set)
+		{
+			xpath_ast_node* n = parse_step(set);
+			if (!n) return 0;
+
+			size_t old_depth = _depth;
+
+			while (_lexer.current() == lex_slash || _lexer.current() == lex_double_slash)
+			{
+				lexeme_t l = _lexer.current();
+				_lexer.next();
+
+				if (l == lex_double_slash)
+				{
+					n = alloc_node(ast_step, n, axis_descendant_or_self, nodetest_type_node, 0);
+					if (!n) return 0;
+
+					++_depth;
+				}
+
+				if (++_depth > xpath_ast_depth_limit)
+					return error_rec();
+
+				n = parse_step(n);
+				if (!n) return 0;
+			}
+
+			_depth = old_depth;
+
+			return n;
+		}
+
+		// LocationPath ::= RelativeLocationPath | AbsoluteLocationPath
+		// AbsoluteLocationPath ::= '/' RelativeLocationPath? | '//' RelativeLocationPath
+		xpath_ast_node* parse_location_path()
+		{
+			if (_lexer.current() == lex_slash)
+			{
+				_lexer.next();
+
+				xpath_ast_node* n = alloc_node(ast_step_root, xpath_type_node_set);
+				if (!n) return 0;
+
+				// relative location path can start from axis_attribute, dot, double_dot, multiply and string lexemes; any other lexeme means standalone root path
+				lexeme_t l = _lexer.current();
+
+				if (l == lex_string || l == lex_axis_attribute || l == lex_dot || l == lex_double_dot || l == lex_multiply)
+					return parse_relative_location_path(n);
+				else
+					return n;
+			}
+			else if (_lexer.current() == lex_double_slash)
+			{
+				_lexer.next();
+
+				xpath_ast_node* n = alloc_node(ast_step_root, xpath_type_node_set);
+				if (!n) return 0;
+
+				n = alloc_node(ast_step, n, axis_descendant_or_self, nodetest_type_node, 0);
+				if (!n) return 0;
+
+				return parse_relative_location_path(n);
+			}
+
+			// else clause moved outside of if because of bogus warning 'control may reach end of non-void function being inlined' in gcc 4.0.1
+			return parse_relative_location_path(0);
+		}
+
+		// PathExpr ::= LocationPath
+		//				| FilterExpr
+		//				| FilterExpr '/' RelativeLocationPath
+		//				| FilterExpr '//' RelativeLocationPath
+		// UnionExpr ::= PathExpr | UnionExpr '|' PathExpr
+		// UnaryExpr ::= UnionExpr | '-' UnaryExpr
+		xpath_ast_node* parse_path_or_unary_expression()
+		{
+			// Clarification.
+			// PathExpr begins with either LocationPath or FilterExpr.
+			// FilterExpr begins with PrimaryExpr
+			// PrimaryExpr begins with '$' in case of it being a variable reference,
+			// '(' in case of it being an expression, string literal, number constant or
+			// function call.
+			if (_lexer.current() == lex_var_ref || _lexer.current() == lex_open_brace ||
+				_lexer.current() == lex_quoted_string || _lexer.current() == lex_number ||
+				_lexer.current() == lex_string)
+			{
+				if (_lexer.current() == lex_string)
+				{
+					// This is either a function call, or not - if not, we shall proceed with location path
+					const char_t* state = _lexer.state();
+
+					while (PUGI_IMPL_IS_CHARTYPE(*state, ct_space)) ++state;
+
+					if (*state != '(')
+						return parse_location_path();
+
+					// This looks like a function call; however this still can be a node-test. Check it.
+					if (parse_node_test_type(_lexer.contents()) != nodetest_none)
+						return parse_location_path();
+				}
+
+				xpath_ast_node* n = parse_filter_expression();
+				if (!n) return 0;
+
+				if (_lexer.current() == lex_slash || _lexer.current() == lex_double_slash)
+				{
+					lexeme_t l = _lexer.current();
+					_lexer.next();
+
+					if (l == lex_double_slash)
+					{
+						if (n->rettype() != xpath_type_node_set)
+							return error("Step has to be applied to node set");
+
+						n = alloc_node(ast_step, n, axis_descendant_or_self, nodetest_type_node, 0);
+						if (!n) return 0;
+					}
+
+					// select from location path
+					return parse_relative_location_path(n);
+				}
+
+				return n;
+			}
+			else if (_lexer.current() == lex_minus)
+			{
+				_lexer.next();
+
+				// precedence 7+ - only parses union expressions
+				xpath_ast_node* n = parse_expression(7);
+				if (!n) return 0;
+
+				return alloc_node(ast_op_negate, xpath_type_number, n);
+			}
+			else
+			{
+				return parse_location_path();
+			}
+		}
+
+		struct binary_op_t
+		{
+			ast_type_t asttype;
+			xpath_value_type rettype;
+			int precedence;
+
+			binary_op_t(): asttype(ast_unknown), rettype(xpath_type_none), precedence(0)
+			{
+			}
+
+			binary_op_t(ast_type_t asttype_, xpath_value_type rettype_, int precedence_): asttype(asttype_), rettype(rettype_), precedence(precedence_)
+			{
+			}
+
+			static binary_op_t parse(xpath_lexer& lexer)
+			{
+				switch (lexer.current())
+				{
+				case lex_string:
+					if (lexer.contents() == PUGIXML_TEXT("or"))
+						return binary_op_t(ast_op_or, xpath_type_boolean, 1);
+					else if (lexer.contents() == PUGIXML_TEXT("and"))
+						return binary_op_t(ast_op_and, xpath_type_boolean, 2);
+					else if (lexer.contents() == PUGIXML_TEXT("div"))
+						return binary_op_t(ast_op_divide, xpath_type_number, 6);
+					else if (lexer.contents() == PUGIXML_TEXT("mod"))
+						return binary_op_t(ast_op_mod, xpath_type_number, 6);
+					else
+						return binary_op_t();
+
+				case lex_equal:
+					return binary_op_t(ast_op_equal, xpath_type_boolean, 3);
+
+				case lex_not_equal:
+					return binary_op_t(ast_op_not_equal, xpath_type_boolean, 3);
+
+				case lex_less:
+					return binary_op_t(ast_op_less, xpath_type_boolean, 4);
+
+				case lex_greater:
+					return binary_op_t(ast_op_greater, xpath_type_boolean, 4);
+
+				case lex_less_or_equal:
+					return binary_op_t(ast_op_less_or_equal, xpath_type_boolean, 4);
+
+				case lex_greater_or_equal:
+					return binary_op_t(ast_op_greater_or_equal, xpath_type_boolean, 4);
+
+				case lex_plus:
+					return binary_op_t(ast_op_add, xpath_type_number, 5);
+
+				case lex_minus:
+					return binary_op_t(ast_op_subtract, xpath_type_number, 5);
+
+				case lex_multiply:
+					return binary_op_t(ast_op_multiply, xpath_type_number, 6);
+
+				case lex_union:
+					return binary_op_t(ast_op_union, xpath_type_node_set, 7);
+
+				default:
+					return binary_op_t();
+				}
+			}
+		};
+
+		xpath_ast_node* parse_expression_rec(xpath_ast_node* lhs, int limit)
+		{
+			binary_op_t op = binary_op_t::parse(_lexer);
+
+			while (op.asttype != ast_unknown && op.precedence >= limit)
+			{
+				_lexer.next();
+
+				if (++_depth > xpath_ast_depth_limit)
+					return error_rec();
+
+				xpath_ast_node* rhs = parse_path_or_unary_expression();
+				if (!rhs) return 0;
+
+				binary_op_t nextop = binary_op_t::parse(_lexer);
+
+				while (nextop.asttype != ast_unknown && nextop.precedence > op.precedence)
+				{
+					rhs = parse_expression_rec(rhs, nextop.precedence);
+					if (!rhs) return 0;
+
+					nextop = binary_op_t::parse(_lexer);
+				}
+
+				if (op.asttype == ast_op_union && (lhs->rettype() != xpath_type_node_set || rhs->rettype() != xpath_type_node_set))
+					return error("Union operator has to be applied to node sets");
+
+				lhs = alloc_node(op.asttype, op.rettype, lhs, rhs);
+				if (!lhs) return 0;
+
+				op = binary_op_t::parse(_lexer);
+			}
+
+			return lhs;
+		}
+
+		// Expr ::= OrExpr
+		// OrExpr ::= AndExpr | OrExpr 'or' AndExpr
+		// AndExpr ::= EqualityExpr | AndExpr 'and' EqualityExpr
+		// EqualityExpr ::= RelationalExpr
+		//					| EqualityExpr '=' RelationalExpr
+		//					| EqualityExpr '!=' RelationalExpr
+		// RelationalExpr ::= AdditiveExpr
+		//					  | RelationalExpr '<' AdditiveExpr
+		//					  | RelationalExpr '>' AdditiveExpr
+		//					  | RelationalExpr '<=' AdditiveExpr
+		//					  | RelationalExpr '>=' AdditiveExpr
+		// AdditiveExpr ::= MultiplicativeExpr
+		//					| AdditiveExpr '+' MultiplicativeExpr
+		//					| AdditiveExpr '-' MultiplicativeExpr
+		// MultiplicativeExpr ::= UnaryExpr
+		//						  | MultiplicativeExpr '*' UnaryExpr
+		//						  | MultiplicativeExpr 'div' UnaryExpr
+		//						  | MultiplicativeExpr 'mod' UnaryExpr
+		xpath_ast_node* parse_expression(int limit = 0)
+		{
+			size_t old_depth = _depth;
+
+			if (++_depth > xpath_ast_depth_limit)
+				return error_rec();
+
+			xpath_ast_node* n = parse_path_or_unary_expression();
+			if (!n) return 0;
+
+			n = parse_expression_rec(n, limit);
+
+			_depth = old_depth;
+
+			return n;
+		}
+
+		xpath_parser(const char_t* query, xpath_variable_set* variables, xpath_allocator* alloc, xpath_parse_result* result): _alloc(alloc), _lexer(query), _query(query), _variables(variables), _result(result), _depth(0)
+		{
+		}
+
+		xpath_ast_node* parse()
+		{
+			xpath_ast_node* n = parse_expression();
+			if (!n) return 0;
+
+			assert(_depth == 0);
+
+			// check if there are unparsed tokens left
+			if (_lexer.current() != lex_eof)
+				return error("Incorrect query");
+
+			return n;
+		}
+
+		static xpath_ast_node* parse(const char_t* query, xpath_variable_set* variables, xpath_allocator* alloc, xpath_parse_result* result)
+		{
+			xpath_parser parser(query, variables, alloc, result);
+
+			return parser.parse();
+		}
+	};
+
+	struct xpath_query_impl
+	{
+		static xpath_query_impl* create()
+		{
+			void* memory = xml_memory::allocate(sizeof(xpath_query_impl));
+			if (!memory) return 0;
+
+			return new (memory) xpath_query_impl();
+		}
+
+		static void destroy(xpath_query_impl* impl)
+		{
+			// free all allocated pages
+			impl->alloc.release();
+
+			// free allocator memory (with the first page)
+			xml_memory::deallocate(impl);
+		}
+
+		xpath_query_impl(): root(0), alloc(&block, &oom), oom(false)
+		{
+			block.next = 0;
+			block.capacity = sizeof(block.data);
+		}
+
+		xpath_ast_node* root;
+		xpath_allocator alloc;
+		xpath_memory_block block;
+		bool oom;
+	};
+
+	PUGI_IMPL_FN impl::xpath_ast_node* evaluate_node_set_prepare(xpath_query_impl* impl)
+	{
+		if (!impl) return 0;
+
+		if (impl->root->rettype() != xpath_type_node_set)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return 0;
+		#else
+			xpath_parse_result res;
+			res.error = "Expression does not evaluate to node set";
+
+			throw xpath_exception(res);
+		#endif
+		}
+
+		return impl->root;
+	}
+PUGI_IMPL_NS_END
+
+namespace pugi
+{
+#ifndef PUGIXML_NO_EXCEPTIONS
+	PUGI_IMPL_FN xpath_exception::xpath_exception(const xpath_parse_result& result_): _result(result_)
+	{
+		assert(_result.error);
+	}
+
+	PUGI_IMPL_FN const char* xpath_exception::what() const throw()
+	{
+		return _result.error;
+	}
+
+	PUGI_IMPL_FN const xpath_parse_result& xpath_exception::result() const
+	{
+		return _result;
+	}
+#endif
+
+	PUGI_IMPL_FN xpath_node::xpath_node()
+	{
+	}
+
+	PUGI_IMPL_FN xpath_node::xpath_node(const xml_node& node_): _node(node_)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_node::xpath_node(const xml_attribute& attribute_, const xml_node& parent_): _node(attribute_ ? parent_ : xml_node()), _attribute(attribute_)
+	{
+	}
+
+	PUGI_IMPL_FN xml_node xpath_node::node() const
+	{
+		return _attribute ? xml_node() : _node;
+	}
+
+	PUGI_IMPL_FN xml_attribute xpath_node::attribute() const
+	{
+		return _attribute;
+	}
+
+	PUGI_IMPL_FN xml_node xpath_node::parent() const
+	{
+		return _attribute ? _node : _node.parent();
+	}
+
+	PUGI_IMPL_FN static void unspecified_bool_xpath_node(xpath_node***)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_node::operator xpath_node::unspecified_bool_type() const
+	{
+		return (_node || _attribute) ? unspecified_bool_xpath_node : 0;
+	}
+
+	PUGI_IMPL_FN bool xpath_node::operator!() const
+	{
+		return !(_node || _attribute);
+	}
+
+	PUGI_IMPL_FN bool xpath_node::operator==(const xpath_node& n) const
+	{
+		return _node == n._node && _attribute == n._attribute;
+	}
+
+	PUGI_IMPL_FN bool xpath_node::operator!=(const xpath_node& n) const
+	{
+		return _node != n._node || _attribute != n._attribute;
+	}
+
+#ifdef __BORLANDC__
+	PUGI_IMPL_FN bool operator&&(const xpath_node& lhs, bool rhs)
+	{
+		return (bool)lhs && rhs;
+	}
+
+	PUGI_IMPL_FN bool operator||(const xpath_node& lhs, bool rhs)
+	{
+		return (bool)lhs || rhs;
+	}
+#endif
+
+	PUGI_IMPL_FN void xpath_node_set::_assign(const_iterator begin_, const_iterator end_, type_t type_)
+	{
+		assert(begin_ <= end_);
+
+		size_t size_ = static_cast<size_t>(end_ - begin_);
+
+		// use internal buffer for 0 or 1 elements, heap buffer otherwise
+		xpath_node* storage = (size_ <= 1) ? _storage : static_cast<xpath_node*>(impl::xml_memory::allocate(size_ * sizeof(xpath_node)));
+
+		if (!storage)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return;
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		// deallocate old buffer
+		if (_begin != _storage)
+			impl::xml_memory::deallocate(_begin);
+
+		// size check is necessary because for begin_ = end_ = nullptr, memcpy is UB
+		if (size_)
+			memcpy(storage, begin_, size_ * sizeof(xpath_node));
+
+		_begin = storage;
+		_end = storage + size_;
+		_type = type_;
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN void xpath_node_set::_move(xpath_node_set& rhs) PUGIXML_NOEXCEPT
+	{
+		_type = rhs._type;
+		_storage[0] = rhs._storage[0];
+		_begin = (rhs._begin == rhs._storage) ? _storage : rhs._begin;
+		_end = _begin + (rhs._end - rhs._begin);
+
+		rhs._type = type_unsorted;
+		rhs._begin = rhs._storage;
+		rhs._end = rhs._storage;
+	}
+#endif
+
+	PUGI_IMPL_FN xpath_node_set::xpath_node_set(): _type(type_unsorted), _begin(_storage), _end(_storage)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_node_set::xpath_node_set(const_iterator begin_, const_iterator end_, type_t type_): _type(type_unsorted), _begin(_storage), _end(_storage)
+	{
+		_assign(begin_, end_, type_);
+	}
+
+	PUGI_IMPL_FN xpath_node_set::~xpath_node_set()
+	{
+		if (_begin != _storage)
+			impl::xml_memory::deallocate(_begin);
+	}
+
+	PUGI_IMPL_FN xpath_node_set::xpath_node_set(const xpath_node_set& ns): _type(type_unsorted), _begin(_storage), _end(_storage)
+	{
+		_assign(ns._begin, ns._end, ns._type);
+	}
+
+	PUGI_IMPL_FN xpath_node_set& xpath_node_set::operator=(const xpath_node_set& ns)
+	{
+		if (this == &ns) return *this;
+
+		_assign(ns._begin, ns._end, ns._type);
+
+		return *this;
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN xpath_node_set::xpath_node_set(xpath_node_set&& rhs) PUGIXML_NOEXCEPT: _type(type_unsorted), _begin(_storage), _end(_storage)
+	{
+		_move(rhs);
+	}
+
+	PUGI_IMPL_FN xpath_node_set& xpath_node_set::operator=(xpath_node_set&& rhs) PUGIXML_NOEXCEPT
+	{
+		if (this == &rhs) return *this;
+
+		if (_begin != _storage)
+			impl::xml_memory::deallocate(_begin);
+
+		_move(rhs);
+
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN xpath_node_set::type_t xpath_node_set::type() const
+	{
+		return _type;
+	}
+
+	PUGI_IMPL_FN size_t xpath_node_set::size() const
+	{
+		return _end - _begin;
+	}
+
+	PUGI_IMPL_FN bool xpath_node_set::empty() const
+	{
+		return _begin == _end;
+	}
+
+	PUGI_IMPL_FN const xpath_node& xpath_node_set::operator[](size_t index) const
+	{
+		assert(index < size());
+		return _begin[index];
+	}
+
+	PUGI_IMPL_FN xpath_node_set::const_iterator xpath_node_set::begin() const
+	{
+		return _begin;
+	}
+
+	PUGI_IMPL_FN xpath_node_set::const_iterator xpath_node_set::end() const
+	{
+		return _end;
+	}
+
+	PUGI_IMPL_FN void xpath_node_set::sort(bool reverse)
+	{
+		_type = impl::xpath_sort(_begin, _end, _type, reverse);
+	}
+
+	PUGI_IMPL_FN xpath_node xpath_node_set::first() const
+	{
+		return impl::xpath_first(_begin, _end, _type);
+	}
+
+	PUGI_IMPL_FN xpath_parse_result::xpath_parse_result(): error("Internal error"), offset(0)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_parse_result::operator bool() const
+	{
+		return error == 0;
+	}
+
+	PUGI_IMPL_FN const char* xpath_parse_result::description() const
+	{
+		return error ? error : "No error";
+	}
+
+	PUGI_IMPL_FN xpath_variable::xpath_variable(xpath_value_type type_): _type(type_), _next(0)
+	{
+	}
+
+	PUGI_IMPL_FN const char_t* xpath_variable::name() const
+	{
+		switch (_type)
+		{
+		case xpath_type_node_set:
+			return static_cast<const impl::xpath_variable_node_set*>(this)->name;
+
+		case xpath_type_number:
+			return static_cast<const impl::xpath_variable_number*>(this)->name;
+
+		case xpath_type_string:
+			return static_cast<const impl::xpath_variable_string*>(this)->name;
+
+		case xpath_type_boolean:
+			return static_cast<const impl::xpath_variable_boolean*>(this)->name;
+
+		default:
+			assert(false && "Invalid variable type"); // unreachable
+			return 0;
+		}
+	}
+
+	PUGI_IMPL_FN xpath_value_type xpath_variable::type() const
+	{
+		return _type;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable::get_boolean() const
+	{
+		return (_type == xpath_type_boolean) ? static_cast<const impl::xpath_variable_boolean*>(this)->value : false;
+	}
+
+	PUGI_IMPL_FN double xpath_variable::get_number() const
+	{
+		return (_type == xpath_type_number) ? static_cast<const impl::xpath_variable_number*>(this)->value : impl::gen_nan();
+	}
+
+	PUGI_IMPL_FN const char_t* xpath_variable::get_string() const
+	{
+		const char_t* value = (_type == xpath_type_string) ? static_cast<const impl::xpath_variable_string*>(this)->value : 0;
+		return value ? value : PUGIXML_TEXT("");
+	}
+
+	PUGI_IMPL_FN const xpath_node_set& xpath_variable::get_node_set() const
+	{
+		return (_type == xpath_type_node_set) ? static_cast<const impl::xpath_variable_node_set*>(this)->value : impl::dummy_node_set;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable::set(bool value)
+	{
+		if (_type != xpath_type_boolean) return false;
+
+		static_cast<impl::xpath_variable_boolean*>(this)->value = value;
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable::set(double value)
+	{
+		if (_type != xpath_type_number) return false;
+
+		static_cast<impl::xpath_variable_number*>(this)->value = value;
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable::set(const char_t* value)
+	{
+		if (_type != xpath_type_string) return false;
+
+		impl::xpath_variable_string* var = static_cast<impl::xpath_variable_string*>(this);
+
+		// duplicate string
+		size_t size = (impl::strlength(value) + 1) * sizeof(char_t);
+
+		char_t* copy = static_cast<char_t*>(impl::xml_memory::allocate(size));
+		if (!copy) return false;
+
+		memcpy(copy, value, size);
+
+		// replace old string
+		if (var->value) impl::xml_memory::deallocate(var->value);
+		var->value = copy;
+
+		return true;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable::set(const xpath_node_set& value)
+	{
+		if (_type != xpath_type_node_set) return false;
+
+		static_cast<impl::xpath_variable_node_set*>(this)->value = value;
+		return true;
+	}
+
+	PUGI_IMPL_FN xpath_variable_set::xpath_variable_set()
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+			_data[i] = 0;
+	}
+
+	PUGI_IMPL_FN xpath_variable_set::~xpath_variable_set()
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+			_destroy(_data[i]);
+	}
+
+	PUGI_IMPL_FN xpath_variable_set::xpath_variable_set(const xpath_variable_set& rhs)
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+			_data[i] = 0;
+
+		_assign(rhs);
+	}
+
+	PUGI_IMPL_FN xpath_variable_set& xpath_variable_set::operator=(const xpath_variable_set& rhs)
+	{
+		if (this == &rhs) return *this;
+
+		_assign(rhs);
+
+		return *this;
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN xpath_variable_set::xpath_variable_set(xpath_variable_set&& rhs) PUGIXML_NOEXCEPT
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+		{
+			_data[i] = rhs._data[i];
+			rhs._data[i] = 0;
+		}
+	}
+
+	PUGI_IMPL_FN xpath_variable_set& xpath_variable_set::operator=(xpath_variable_set&& rhs) PUGIXML_NOEXCEPT
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+		{
+			_destroy(_data[i]);
+
+			_data[i] = rhs._data[i];
+			rhs._data[i] = 0;
+		}
+
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN void xpath_variable_set::_assign(const xpath_variable_set& rhs)
+	{
+		xpath_variable_set temp;
+
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+			if (rhs._data[i] && !_clone(rhs._data[i], &temp._data[i]))
+				return;
+
+		_swap(temp);
+	}
+
+	PUGI_IMPL_FN void xpath_variable_set::_swap(xpath_variable_set& rhs)
+	{
+		for (size_t i = 0; i < sizeof(_data) / sizeof(_data[0]); ++i)
+		{
+			xpath_variable* chain = _data[i];
+
+			_data[i] = rhs._data[i];
+			rhs._data[i] = chain;
+		}
+	}
+
+	PUGI_IMPL_FN xpath_variable* xpath_variable_set::_find(const char_t* name) const
+	{
+		const size_t hash_size = sizeof(_data) / sizeof(_data[0]);
+		size_t hash = impl::hash_string(name) % hash_size;
+
+		// look for existing variable
+		for (xpath_variable* var = _data[hash]; var; var = var->_next)
+			if (impl::strequal(var->name(), name))
+				return var;
+
+		return 0;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable_set::_clone(xpath_variable* var, xpath_variable** out_result)
+	{
+		xpath_variable* last = 0;
+
+		while (var)
+		{
+			// allocate storage for new variable
+			xpath_variable* nvar = impl::new_xpath_variable(var->_type, var->name());
+			if (!nvar) return false;
+
+			// link the variable to the result immediately to handle failures gracefully
+			if (last)
+				last->_next = nvar;
+			else
+				*out_result = nvar;
+
+			last = nvar;
+
+			// copy the value; this can fail due to out-of-memory conditions
+			if (!impl::copy_xpath_variable(nvar, var)) return false;
+
+			var = var->_next;
+		}
+
+		return true;
+	}
+
+	PUGI_IMPL_FN void xpath_variable_set::_destroy(xpath_variable* var)
+	{
+		while (var)
+		{
+			xpath_variable* next = var->_next;
+
+			impl::delete_xpath_variable(var->_type, var);
+
+			var = next;
+		}
+	}
+
+	PUGI_IMPL_FN xpath_variable* xpath_variable_set::add(const char_t* name, xpath_value_type type)
+	{
+		const size_t hash_size = sizeof(_data) / sizeof(_data[0]);
+		size_t hash = impl::hash_string(name) % hash_size;
+
+		// look for existing variable
+		for (xpath_variable* var = _data[hash]; var; var = var->_next)
+			if (impl::strequal(var->name(), name))
+				return var->type() == type ? var : 0;
+
+		// add new variable
+		xpath_variable* result = impl::new_xpath_variable(type, name);
+
+		if (result)
+		{
+			result->_next = _data[hash];
+
+			_data[hash] = result;
+		}
+
+		return result;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable_set::set(const char_t* name, bool value)
+	{
+		xpath_variable* var = add(name, xpath_type_boolean);
+		return var ? var->set(value) : false;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable_set::set(const char_t* name, double value)
+	{
+		xpath_variable* var = add(name, xpath_type_number);
+		return var ? var->set(value) : false;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable_set::set(const char_t* name, const char_t* value)
+	{
+		xpath_variable* var = add(name, xpath_type_string);
+		return var ? var->set(value) : false;
+	}
+
+	PUGI_IMPL_FN bool xpath_variable_set::set(const char_t* name, const xpath_node_set& value)
+	{
+		xpath_variable* var = add(name, xpath_type_node_set);
+		return var ? var->set(value) : false;
+	}
+
+	PUGI_IMPL_FN xpath_variable* xpath_variable_set::get(const char_t* name)
+	{
+		return _find(name);
+	}
+
+	PUGI_IMPL_FN const xpath_variable* xpath_variable_set::get(const char_t* name) const
+	{
+		return _find(name);
+	}
+
+	PUGI_IMPL_FN xpath_query::xpath_query(const char_t* query, xpath_variable_set* variables): _impl(0)
+	{
+		impl::xpath_query_impl* qimpl = impl::xpath_query_impl::create();
+
+		if (!qimpl)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			_result.error = "Out of memory";
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+		else
+		{
+			using impl::auto_deleter; // MSVC7 workaround
+			auto_deleter<impl::xpath_query_impl> impl(qimpl, impl::xpath_query_impl::destroy);
+
+			qimpl->root = impl::xpath_parser::parse(query, variables, &qimpl->alloc, &_result);
+
+			if (qimpl->root)
+			{
+				qimpl->root->optimize(&qimpl->alloc);
+
+				_impl = impl.release();
+				_result.error = 0;
+			}
+			else
+			{
+			#ifdef PUGIXML_NO_EXCEPTIONS
+				if (qimpl->oom) _result.error = "Out of memory";
+			#else
+				if (qimpl->oom) throw std::bad_alloc();
+				throw xpath_exception(_result);
+			#endif
+			}
+		}
+	}
+
+	PUGI_IMPL_FN xpath_query::xpath_query(): _impl(0)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_query::~xpath_query()
+	{
+		if (_impl)
+			impl::xpath_query_impl::destroy(static_cast<impl::xpath_query_impl*>(_impl));
+	}
+
+#ifdef PUGIXML_HAS_MOVE
+	PUGI_IMPL_FN xpath_query::xpath_query(xpath_query&& rhs) PUGIXML_NOEXCEPT
+	{
+		_impl = rhs._impl;
+		_result = rhs._result;
+		rhs._impl = 0;
+		rhs._result = xpath_parse_result();
+	}
+
+	PUGI_IMPL_FN xpath_query& xpath_query::operator=(xpath_query&& rhs) PUGIXML_NOEXCEPT
+	{
+		if (this == &rhs) return *this;
+
+		if (_impl)
+			impl::xpath_query_impl::destroy(static_cast<impl::xpath_query_impl*>(_impl));
+
+		_impl = rhs._impl;
+		_result = rhs._result;
+		rhs._impl = 0;
+		rhs._result = xpath_parse_result();
+
+		return *this;
+	}
+#endif
+
+	PUGI_IMPL_FN xpath_value_type xpath_query::return_type() const
+	{
+		if (!_impl) return xpath_type_none;
+
+		return static_cast<impl::xpath_query_impl*>(_impl)->root->rettype();
+	}
+
+	PUGI_IMPL_FN bool xpath_query::evaluate_boolean(const xpath_node& n) const
+	{
+		if (!_impl) return false;
+
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		bool r = static_cast<impl::xpath_query_impl*>(_impl)->root->eval_boolean(c, sd.stack);
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return false;
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		return r;
+	}
+
+	PUGI_IMPL_FN double xpath_query::evaluate_number(const xpath_node& n) const
+	{
+		if (!_impl) return impl::gen_nan();
+
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		double r = static_cast<impl::xpath_query_impl*>(_impl)->root->eval_number(c, sd.stack);
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return impl::gen_nan();
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		return r;
+	}
+
+#ifndef PUGIXML_NO_STL
+	PUGI_IMPL_FN string_t xpath_query::evaluate_string(const xpath_node& n) const
+	{
+		if (!_impl) return string_t();
+
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		impl::xpath_string r = static_cast<impl::xpath_query_impl*>(_impl)->root->eval_string(c, sd.stack);
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return string_t();
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		return string_t(r.c_str(), r.length());
+	}
+#endif
+
+	PUGI_IMPL_FN size_t xpath_query::evaluate_string(char_t* buffer, size_t capacity, const xpath_node& n) const
+	{
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		impl::xpath_string r = _impl ? static_cast<impl::xpath_query_impl*>(_impl)->root->eval_string(c, sd.stack) : impl::xpath_string();
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			r = impl::xpath_string();
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		size_t full_size = r.length() + 1;
+
+		if (capacity > 0)
+		{
+			size_t size = (full_size < capacity) ? full_size : capacity;
+			assert(size > 0);
+
+			memcpy(buffer, r.c_str(), (size - 1) * sizeof(char_t));
+			buffer[size - 1] = 0;
+		}
+
+		return full_size;
+	}
+
+	PUGI_IMPL_FN xpath_node_set xpath_query::evaluate_node_set(const xpath_node& n) const
+	{
+		impl::xpath_ast_node* root = impl::evaluate_node_set_prepare(static_cast<impl::xpath_query_impl*>(_impl));
+		if (!root) return xpath_node_set();
+
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		impl::xpath_node_set_raw r = root->eval_node_set(c, sd.stack, impl::nodeset_eval_all);
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return xpath_node_set();
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		return xpath_node_set(r.begin(), r.end(), r.type());
+	}
+
+	PUGI_IMPL_FN xpath_node xpath_query::evaluate_node(const xpath_node& n) const
+	{
+		impl::xpath_ast_node* root = impl::evaluate_node_set_prepare(static_cast<impl::xpath_query_impl*>(_impl));
+		if (!root) return xpath_node();
+
+		impl::xpath_context c(n, 1, 1);
+		impl::xpath_stack_data sd;
+
+		impl::xpath_node_set_raw r = root->eval_node_set(c, sd.stack, impl::nodeset_eval_first);
+
+		if (sd.oom)
+		{
+		#ifdef PUGIXML_NO_EXCEPTIONS
+			return xpath_node();
+		#else
+			throw std::bad_alloc();
+		#endif
+		}
+
+		return r.first();
+	}
+
+	PUGI_IMPL_FN const xpath_parse_result& xpath_query::result() const
+	{
+		return _result;
+	}
+
+	PUGI_IMPL_FN static void unspecified_bool_xpath_query(xpath_query***)
+	{
+	}
+
+	PUGI_IMPL_FN xpath_query::operator xpath_query::unspecified_bool_type() const
+	{
+		return _impl ? unspecified_bool_xpath_query : 0;
+	}
+
+	PUGI_IMPL_FN bool xpath_query::operator!() const
+	{
+		return !_impl;
+	}
+
+	PUGI_IMPL_FN xpath_node xml_node::select_node(const char_t* query, xpath_variable_set* variables) const
+	{
+		xpath_query q(query, variables);
+		return q.evaluate_node(*this);
+	}
+
+	PUGI_IMPL_FN xpath_node xml_node::select_node(const xpath_query& query) const
+	{
+		return query.evaluate_node(*this);
+	}
+
+	PUGI_IMPL_FN xpath_node_set xml_node::select_nodes(const char_t* query, xpath_variable_set* variables) const
+	{
+		xpath_query q(query, variables);
+		return q.evaluate_node_set(*this);
+	}
+
+	PUGI_IMPL_FN xpath_node_set xml_node::select_nodes(const xpath_query& query) const
+	{
+		return query.evaluate_node_set(*this);
+	}
+
+	PUGI_IMPL_FN xpath_node xml_node::select_single_node(const char_t* query, xpath_variable_set* variables) const
+	{
+		xpath_query q(query, variables);
+		return q.evaluate_node(*this);
+	}
+
+	PUGI_IMPL_FN xpath_node xml_node::select_single_node(const xpath_query& query) const
+	{
+		return query.evaluate_node(*this);
+	}
+}
+
+#endif
+
+#ifdef __BORLANDC__
+#	pragma option pop
+#endif
+
+// Intel C++ does not properly keep warning state for function templates,
+// so popping warning state at the end of translation unit leads to warnings in the middle.
+#if defined(_MSC_VER) && !defined(__INTEL_COMPILER)
+#	pragma warning(pop)
+#endif
+
+#if defined(_MSC_VER) && defined(__c2__)
+#	pragma clang diagnostic pop
+#endif
+
+// Undefine all local macros (makes sure we're not leaking macros in header-only mode)
+#undef PUGI_IMPL_NO_INLINE
+#undef PUGI_IMPL_UNLIKELY
+#undef PUGI_IMPL_STATIC_ASSERT
+#undef PUGI_IMPL_DMC_VOLATILE
+#undef PUGI_IMPL_UNSIGNED_OVERFLOW
+#undef PUGI_IMPL_MSVC_CRT_VERSION
+#undef PUGI_IMPL_SNPRINTF
+#undef PUGI_IMPL_NS_BEGIN
+#undef PUGI_IMPL_NS_END
+#undef PUGI_IMPL_FN
+#undef PUGI_IMPL_FN_NO_INLINE
+#undef PUGI_IMPL_GETHEADER_IMPL
+#undef PUGI_IMPL_GETPAGE_IMPL
+#undef PUGI_IMPL_GETPAGE
+#undef PUGI_IMPL_NODETYPE
+#undef PUGI_IMPL_IS_CHARTYPE_IMPL
+#undef PUGI_IMPL_IS_CHARTYPE
+#undef PUGI_IMPL_IS_CHARTYPEX
+#undef PUGI_IMPL_ENDSWITH
+#undef PUGI_IMPL_SKIPWS
+#undef PUGI_IMPL_OPTSET
+#undef PUGI_IMPL_PUSHNODE
+#undef PUGI_IMPL_POPNODE
+#undef PUGI_IMPL_SCANFOR
+#undef PUGI_IMPL_SCANWHILE
+#undef PUGI_IMPL_SCANWHILE_UNROLL
+#undef PUGI_IMPL_ENDSEG
+#undef PUGI_IMPL_THROW_ERROR
+#undef PUGI_IMPL_CHECK_ERROR
+
+#endif
+
+/**
+ * Copyright (c) 2006-2023 Arseny Kapoulkine
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */

+ 1516 - 0
pico-tcp-service/pico-tcp/pugixml.hpp

@@ -0,0 +1,1516 @@
+/**
+ * pugixml parser - version 1.14
+ * --------------------------------------------------------
+ * Copyright (C) 2006-2023, by Arseny Kapoulkine (arseny.kapoulkine@gmail.com)
+ * Report bugs and download new versions at https://pugixml.org/
+ *
+ * This library is distributed under the MIT License. See notice at the end
+ * of this file.
+ *
+ * This work is based on the pugxml parser, which is:
+ * Copyright (C) 2003, by Kristen Wegner (kristen@tima.net)
+ */
+
+// Define version macro; evaluates to major * 1000 + minor * 10 + patch so that it's safe to use in less-than comparisons
+// Note: pugixml used major * 100 + minor * 10 + patch format up until 1.9 (which had version identifier 190); starting from pugixml 1.10, the minor version number is two digits
+#ifndef PUGIXML_VERSION
+#	define PUGIXML_VERSION 1140 // 1.14
+#endif
+
+// Include user configuration file (this can define various configuration macros)
+#include "pugiconfig.hpp"
+
+#ifndef HEADER_PUGIXML_HPP
+#define HEADER_PUGIXML_HPP
+
+// Include stddef.h for size_t and ptrdiff_t
+#include <stddef.h>
+
+// Include exception header for XPath
+#if !defined(PUGIXML_NO_XPATH) && !defined(PUGIXML_NO_EXCEPTIONS)
+#	include <exception>
+#endif
+
+// Include STL headers
+#ifndef PUGIXML_NO_STL
+#	include <iterator>
+#	include <iosfwd>
+#	include <string>
+#endif
+
+// Macro for deprecated features
+#ifndef PUGIXML_DEPRECATED
+#	if defined(__GNUC__)
+#		define PUGIXML_DEPRECATED __attribute__((deprecated))
+#	elif defined(_MSC_VER) && _MSC_VER >= 1300
+#		define PUGIXML_DEPRECATED __declspec(deprecated)
+#	else
+#		define PUGIXML_DEPRECATED
+#	endif
+#endif
+
+// If no API is defined, assume default
+#ifndef PUGIXML_API
+#	define PUGIXML_API
+#endif
+
+// If no API for classes is defined, assume default
+#ifndef PUGIXML_CLASS
+#	define PUGIXML_CLASS PUGIXML_API
+#endif
+
+// If no API for functions is defined, assume default
+#ifndef PUGIXML_FUNCTION
+#	define PUGIXML_FUNCTION PUGIXML_API
+#endif
+
+// If the platform is known to have long long support, enable long long functions
+#ifndef PUGIXML_HAS_LONG_LONG
+#	if __cplusplus >= 201103
+#		define PUGIXML_HAS_LONG_LONG
+#	elif defined(_MSC_VER) && _MSC_VER >= 1400
+#		define PUGIXML_HAS_LONG_LONG
+#	endif
+#endif
+
+// If the platform is known to have move semantics support, compile move ctor/operator implementation
+#ifndef PUGIXML_HAS_MOVE
+#	if __cplusplus >= 201103
+#		define PUGIXML_HAS_MOVE
+#	elif defined(_MSC_VER) && _MSC_VER >= 1600
+#		define PUGIXML_HAS_MOVE
+#	endif
+#endif
+
+// If C++ is 2011 or higher, add 'noexcept' specifiers
+#ifndef PUGIXML_NOEXCEPT
+#	if __cplusplus >= 201103
+#		define PUGIXML_NOEXCEPT noexcept
+#	elif defined(_MSC_VER) && _MSC_VER >= 1900
+#		define PUGIXML_NOEXCEPT noexcept
+#	else
+#		define PUGIXML_NOEXCEPT
+#	endif
+#endif
+
+// Some functions can not be noexcept in compact mode
+#ifdef PUGIXML_COMPACT
+#	define PUGIXML_NOEXCEPT_IF_NOT_COMPACT
+#else
+#	define PUGIXML_NOEXCEPT_IF_NOT_COMPACT PUGIXML_NOEXCEPT
+#endif
+
+// If C++ is 2011 or higher, add 'override' qualifiers
+#ifndef PUGIXML_OVERRIDE
+#	if __cplusplus >= 201103
+#		define PUGIXML_OVERRIDE override
+#	elif defined(_MSC_VER) && _MSC_VER >= 1700
+#		define PUGIXML_OVERRIDE override
+#	else
+#		define PUGIXML_OVERRIDE
+#	endif
+#endif
+
+// If C++ is 2011 or higher, use 'nullptr'
+#ifndef PUGIXML_NULL
+#	if __cplusplus >= 201103
+#		define PUGIXML_NULL nullptr
+#	elif defined(_MSC_VER) && _MSC_VER >= 1600
+#		define PUGIXML_NULL nullptr
+#	else
+#		define PUGIXML_NULL 0
+#	endif
+#endif
+
+// Character interface macros
+#ifdef PUGIXML_WCHAR_MODE
+#	define PUGIXML_TEXT(t) L ## t
+#	define PUGIXML_CHAR wchar_t
+#else
+#	define PUGIXML_TEXT(t) t
+#	define PUGIXML_CHAR char
+#endif
+
+namespace pugi
+{
+	// Character type used for all internal storage and operations; depends on PUGIXML_WCHAR_MODE
+	typedef PUGIXML_CHAR char_t;
+
+#ifndef PUGIXML_NO_STL
+	// String type used for operations that work with STL string; depends on PUGIXML_WCHAR_MODE
+	typedef std::basic_string<PUGIXML_CHAR, std::char_traits<PUGIXML_CHAR>, std::allocator<PUGIXML_CHAR> > string_t;
+#endif
+}
+
+// The PugiXML namespace
+namespace pugi
+{
+	// Tree node types
+	enum xml_node_type
+	{
+		node_null,			// Empty (null) node handle
+		node_document,		// A document tree's absolute root
+		node_element,		// Element tag, i.e. '<node/>'
+		node_pcdata,		// Plain character data, i.e. 'text'
+		node_cdata,			// Character data, i.e. '<![CDATA[text]]>'
+		node_comment,		// Comment tag, i.e. '<!-- text -->'
+		node_pi,			// Processing instruction, i.e. '<?name?>'
+		node_declaration,	// Document declaration, i.e. '<?xml version="1.0"?>'
+		node_doctype		// Document type declaration, i.e. '<!DOCTYPE doc>'
+	};
+
+	// Parsing options
+
+	// Minimal parsing mode (equivalent to turning all other flags off).
+	// Only elements and PCDATA sections are added to the DOM tree, no text conversions are performed.
+	const unsigned int parse_minimal = 0x0000;
+
+	// This flag determines if processing instructions (node_pi) are added to the DOM tree. This flag is off by default.
+	const unsigned int parse_pi = 0x0001;
+
+	// This flag determines if comments (node_comment) are added to the DOM tree. This flag is off by default.
+	const unsigned int parse_comments = 0x0002;
+
+	// This flag determines if CDATA sections (node_cdata) are added to the DOM tree. This flag is on by default.
+	const unsigned int parse_cdata = 0x0004;
+
+	// This flag determines if plain character data (node_pcdata) that consist only of whitespace are added to the DOM tree.
+	// This flag is off by default; turning it on usually results in slower parsing and more memory consumption.
+	const unsigned int parse_ws_pcdata = 0x0008;
+
+	// This flag determines if character and entity references are expanded during parsing. This flag is on by default.
+	const unsigned int parse_escapes = 0x0010;
+
+	// This flag determines if EOL characters are normalized (converted to #xA) during parsing. This flag is on by default.
+	const unsigned int parse_eol = 0x0020;
+
+	// This flag determines if attribute values are normalized using CDATA normalization rules during parsing. This flag is on by default.
+	const unsigned int parse_wconv_attribute = 0x0040;
+
+	// This flag determines if attribute values are normalized using NMTOKENS normalization rules during parsing. This flag is off by default.
+	const unsigned int parse_wnorm_attribute = 0x0080;
+
+	// This flag determines if document declaration (node_declaration) is added to the DOM tree. This flag is off by default.
+	const unsigned int parse_declaration = 0x0100;
+
+	// This flag determines if document type declaration (node_doctype) is added to the DOM tree. This flag is off by default.
+	const unsigned int parse_doctype = 0x0200;
+
+	// This flag determines if plain character data (node_pcdata) that is the only child of the parent node and that consists only
+	// of whitespace is added to the DOM tree.
+	// This flag is off by default; turning it on may result in slower parsing and more memory consumption.
+	const unsigned int parse_ws_pcdata_single = 0x0400;
+
+	// This flag determines if leading and trailing whitespace is to be removed from plain character data. This flag is off by default.
+	const unsigned int parse_trim_pcdata = 0x0800;
+
+	// This flag determines if plain character data that does not have a parent node is added to the DOM tree, and if an empty document
+	// is a valid document. This flag is off by default.
+	const unsigned int parse_fragment = 0x1000;
+
+	// This flag determines if plain character data is be stored in the parent element's value. This significantly changes the structure of
+	// the document; this flag is only recommended for parsing documents with many PCDATA nodes in memory-constrained environments.
+	// This flag is off by default.
+	const unsigned int parse_embed_pcdata = 0x2000;
+	
+	// This flag determines whether determines whether the the two pcdata should be merged or not, if no intermediatory data are parsed in the document.
+	// This flag is off by default.
+	const unsigned int parse_merge_pcdata = 0x4000;
+
+	// The default parsing mode.
+	// Elements, PCDATA and CDATA sections are added to the DOM tree, character/reference entities are expanded,
+	// End-of-Line characters are normalized, attribute values are normalized using CDATA normalization rules.
+	const unsigned int parse_default = parse_cdata | parse_escapes | parse_wconv_attribute | parse_eol;
+
+	// The full parsing mode.
+	// Nodes of all types are added to the DOM tree, character/reference entities are expanded,
+	// End-of-Line characters are normalized, attribute values are normalized using CDATA normalization rules.
+	const unsigned int parse_full = parse_default | parse_pi | parse_comments | parse_declaration | parse_doctype;
+
+	// These flags determine the encoding of input data for XML document
+	enum xml_encoding
+	{
+		encoding_auto,		// Auto-detect input encoding using BOM or < / <? detection; use UTF8 if BOM is not found
+		encoding_utf8,		// UTF8 encoding
+		encoding_utf16_le,	// Little-endian UTF16
+		encoding_utf16_be,	// Big-endian UTF16
+		encoding_utf16,		// UTF16 with native endianness
+		encoding_utf32_le,	// Little-endian UTF32
+		encoding_utf32_be,	// Big-endian UTF32
+		encoding_utf32,		// UTF32 with native endianness
+		encoding_wchar,		// The same encoding wchar_t has (either UTF16 or UTF32)
+		encoding_latin1
+	};
+
+	// Formatting flags
+
+	// Indent the nodes that are written to output stream with as many indentation strings as deep the node is in DOM tree. This flag is on by default.
+	const unsigned int format_indent = 0x01;
+
+	// Write encoding-specific BOM to the output stream. This flag is off by default.
+	const unsigned int format_write_bom = 0x02;
+
+	// Use raw output mode (no indentation and no line breaks are written). This flag is off by default.
+	const unsigned int format_raw = 0x04;
+
+	// Omit default XML declaration even if there is no declaration in the document. This flag is off by default.
+	const unsigned int format_no_declaration = 0x08;
+
+	// Don't escape attribute values and PCDATA contents. This flag is off by default.
+	const unsigned int format_no_escapes = 0x10;
+
+	// Open file using text mode in xml_document::save_file. This enables special character (i.e. new-line) conversions on some systems. This flag is off by default.
+	const unsigned int format_save_file_text = 0x20;
+
+	// Write every attribute on a new line with appropriate indentation. This flag is off by default.
+	const unsigned int format_indent_attributes = 0x40;
+
+	// Don't output empty element tags, instead writing an explicit start and end tag even if there are no children. This flag is off by default.
+	const unsigned int format_no_empty_element_tags = 0x80;
+
+	// Skip characters belonging to range [0; 32) instead of "&#xNN;" encoding. This flag is off by default.
+	const unsigned int format_skip_control_chars = 0x100;
+
+	// Use single quotes ' instead of double quotes " for enclosing attribute values. This flag is off by default.
+	const unsigned int format_attribute_single_quote = 0x200;
+
+	// The default set of formatting flags.
+	// Nodes are indented depending on their depth in DOM tree, a default declaration is output if document has none.
+	const unsigned int format_default = format_indent;
+
+	const int default_double_precision = 17;
+	const int default_float_precision = 9;
+
+	// Forward declarations
+	struct xml_attribute_struct;
+	struct xml_node_struct;
+
+	class xml_node_iterator;
+	class xml_attribute_iterator;
+	class xml_named_node_iterator;
+
+	class xml_tree_walker;
+
+	struct xml_parse_result;
+
+	class xml_node;
+
+	class xml_text;
+
+	#ifndef PUGIXML_NO_XPATH
+	class xpath_node;
+	class xpath_node_set;
+	class xpath_query;
+	class xpath_variable_set;
+	#endif
+
+	// Range-based for loop support
+	template <typename It> class xml_object_range
+	{
+	public:
+		typedef It const_iterator;
+		typedef It iterator;
+
+		xml_object_range(It b, It e): _begin(b), _end(e)
+		{
+		}
+
+		It begin() const { return _begin; }
+		It end() const { return _end; }
+
+		bool empty() const { return _begin == _end; }
+
+	private:
+		It _begin, _end;
+	};
+
+	// Writer interface for node printing (see xml_node::print)
+	class PUGIXML_CLASS xml_writer
+	{
+	public:
+		virtual ~xml_writer();
+
+		// Write memory chunk into stream/file/whatever
+		virtual void write(const void* data, size_t size) = 0;
+	};
+
+	// xml_writer implementation for FILE*
+	class PUGIXML_CLASS xml_writer_file: public xml_writer
+	{
+	public:
+		// Construct writer from a FILE* object; void* is used to avoid header dependencies on stdio
+		xml_writer_file(void* file);
+
+		virtual void write(const void* data, size_t size) PUGIXML_OVERRIDE;
+
+	private:
+		void* file;
+	};
+
+	#ifndef PUGIXML_NO_STL
+	// xml_writer implementation for streams
+	class PUGIXML_CLASS xml_writer_stream: public xml_writer
+	{
+	public:
+		// Construct writer from an output stream object
+		xml_writer_stream(std::basic_ostream<char, std::char_traits<char> >& stream);
+		xml_writer_stream(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& stream);
+
+		virtual void write(const void* data, size_t size) PUGIXML_OVERRIDE;
+
+	private:
+		std::basic_ostream<char, std::char_traits<char> >* narrow_stream;
+		std::basic_ostream<wchar_t, std::char_traits<wchar_t> >* wide_stream;
+	};
+	#endif
+
+	// A light-weight handle for manipulating attributes in DOM tree
+	class PUGIXML_CLASS xml_attribute
+	{
+		friend class xml_attribute_iterator;
+		friend class xml_node;
+
+	private:
+		xml_attribute_struct* _attr;
+
+		typedef void (*unspecified_bool_type)(xml_attribute***);
+
+	public:
+		// Default constructor. Constructs an empty attribute.
+		xml_attribute();
+
+		// Constructs attribute from internal pointer
+		explicit xml_attribute(xml_attribute_struct* attr);
+
+		// Safe bool conversion operator
+		operator unspecified_bool_type() const;
+
+		// Borland C++ workaround
+		bool operator!() const;
+
+		// Comparison operators (compares wrapped attribute pointers)
+		bool operator==(const xml_attribute& r) const;
+		bool operator!=(const xml_attribute& r) const;
+		bool operator<(const xml_attribute& r) const;
+		bool operator>(const xml_attribute& r) const;
+		bool operator<=(const xml_attribute& r) const;
+		bool operator>=(const xml_attribute& r) const;
+
+		// Check if attribute is empty
+		bool empty() const;
+
+		// Get attribute name/value, or "" if attribute is empty
+		const char_t* name() const;
+		const char_t* value() const;
+
+		// Get attribute value, or the default value if attribute is empty
+		const char_t* as_string(const char_t* def = PUGIXML_TEXT("")) const;
+
+		// Get attribute value as a number, or the default value if conversion did not succeed or attribute is empty
+		int as_int(int def = 0) const;
+		unsigned int as_uint(unsigned int def = 0) const;
+		double as_double(double def = 0) const;
+		float as_float(float def = 0) const;
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		long long as_llong(long long def = 0) const;
+		unsigned long long as_ullong(unsigned long long def = 0) const;
+	#endif
+
+		// Get attribute value as bool (returns true if first character is in '1tTyY' set), or the default value if attribute is empty
+		bool as_bool(bool def = false) const;
+
+		// Set attribute name/value (returns false if attribute is empty or there is not enough memory)
+		bool set_name(const char_t* rhs);
+		bool set_name(const char_t* rhs, size_t size);
+		bool set_value(const char_t* rhs);
+		bool set_value(const char_t* rhs, size_t size);
+
+		// Set attribute value with type conversion (numbers are converted to strings, boolean is converted to "true"/"false")
+		bool set_value(int rhs);
+		bool set_value(unsigned int rhs);
+		bool set_value(long rhs);
+		bool set_value(unsigned long rhs);
+		bool set_value(double rhs);
+		bool set_value(double rhs, int precision);
+		bool set_value(float rhs);
+		bool set_value(float rhs, int precision);
+		bool set_value(bool rhs);
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		bool set_value(long long rhs);
+		bool set_value(unsigned long long rhs);
+	#endif
+
+		// Set attribute value (equivalent to set_value without error checking)
+		xml_attribute& operator=(const char_t* rhs);
+		xml_attribute& operator=(int rhs);
+		xml_attribute& operator=(unsigned int rhs);
+		xml_attribute& operator=(long rhs);
+		xml_attribute& operator=(unsigned long rhs);
+		xml_attribute& operator=(double rhs);
+		xml_attribute& operator=(float rhs);
+		xml_attribute& operator=(bool rhs);
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		xml_attribute& operator=(long long rhs);
+		xml_attribute& operator=(unsigned long long rhs);
+	#endif
+
+		// Get next/previous attribute in the attribute list of the parent node
+		xml_attribute next_attribute() const;
+		xml_attribute previous_attribute() const;
+
+		// Get hash value (unique for handles to the same object)
+		size_t hash_value() const;
+
+		// Get internal pointer
+		xml_attribute_struct* internal_object() const;
+	};
+
+#ifdef __BORLANDC__
+	// Borland C++ workaround
+	bool PUGIXML_FUNCTION operator&&(const xml_attribute& lhs, bool rhs);
+	bool PUGIXML_FUNCTION operator||(const xml_attribute& lhs, bool rhs);
+#endif
+
+	// A light-weight handle for manipulating nodes in DOM tree
+	class PUGIXML_CLASS xml_node
+	{
+		friend class xml_attribute_iterator;
+		friend class xml_node_iterator;
+		friend class xml_named_node_iterator;
+
+	protected:
+		xml_node_struct* _root;
+
+		typedef void (*unspecified_bool_type)(xml_node***);
+
+	public:
+		// Default constructor. Constructs an empty node.
+		xml_node();
+
+		// Constructs node from internal pointer
+		explicit xml_node(xml_node_struct* p);
+
+		// Safe bool conversion operator
+		operator unspecified_bool_type() const;
+
+		// Borland C++ workaround
+		bool operator!() const;
+
+		// Comparison operators (compares wrapped node pointers)
+		bool operator==(const xml_node& r) const;
+		bool operator!=(const xml_node& r) const;
+		bool operator<(const xml_node& r) const;
+		bool operator>(const xml_node& r) const;
+		bool operator<=(const xml_node& r) const;
+		bool operator>=(const xml_node& r) const;
+
+		// Check if node is empty.
+		bool empty() const;
+
+		// Get node type
+		xml_node_type type() const;
+
+		// Get node name, or "" if node is empty or it has no name
+		const char_t* name() const;
+
+		// Get node value, or "" if node is empty or it has no value
+		// Note: For <node>text</node> node.value() does not return "text"! Use child_value() or text() methods to access text inside nodes.
+		const char_t* value() const;
+
+		// Get attribute list
+		xml_attribute first_attribute() const;
+		xml_attribute last_attribute() const;
+
+		// Get children list
+		xml_node first_child() const;
+		xml_node last_child() const;
+
+		// Get next/previous sibling in the children list of the parent node
+		xml_node next_sibling() const;
+		xml_node previous_sibling() const;
+
+		// Get parent node
+		xml_node parent() const;
+
+		// Get root of DOM tree this node belongs to
+		xml_node root() const;
+
+		// Get text object for the current node
+		xml_text text() const;
+
+		// Get child, attribute or next/previous sibling with the specified name
+		xml_node child(const char_t* name) const;
+		xml_attribute attribute(const char_t* name) const;
+		xml_node next_sibling(const char_t* name) const;
+		xml_node previous_sibling(const char_t* name) const;
+
+		// Get attribute, starting the search from a hint (and updating hint so that searching for a sequence of attributes is fast)
+		xml_attribute attribute(const char_t* name, xml_attribute& hint) const;
+
+		// Get child value of current node; that is, value of the first child node of type PCDATA/CDATA
+		const char_t* child_value() const;
+
+		// Get child value of child with specified name. Equivalent to child(name).child_value().
+		const char_t* child_value(const char_t* name) const;
+
+		// Set node name/value (returns false if node is empty, there is not enough memory, or node can not have name/value)
+		bool set_name(const char_t* rhs);
+		bool set_name(const char_t* rhs, size_t size);
+		bool set_value(const char_t* rhs);
+		bool set_value(const char_t* rhs, size_t size);
+
+		// Add attribute with specified name. Returns added attribute, or empty attribute on errors.
+		xml_attribute append_attribute(const char_t* name);
+		xml_attribute prepend_attribute(const char_t* name);
+		xml_attribute insert_attribute_after(const char_t* name, const xml_attribute& attr);
+		xml_attribute insert_attribute_before(const char_t* name, const xml_attribute& attr);
+
+		// Add a copy of the specified attribute. Returns added attribute, or empty attribute on errors.
+		xml_attribute append_copy(const xml_attribute& proto);
+		xml_attribute prepend_copy(const xml_attribute& proto);
+		xml_attribute insert_copy_after(const xml_attribute& proto, const xml_attribute& attr);
+		xml_attribute insert_copy_before(const xml_attribute& proto, const xml_attribute& attr);
+
+		// Add child node with specified type. Returns added node, or empty node on errors.
+		xml_node append_child(xml_node_type type = node_element);
+		xml_node prepend_child(xml_node_type type = node_element);
+		xml_node insert_child_after(xml_node_type type, const xml_node& node);
+		xml_node insert_child_before(xml_node_type type, const xml_node& node);
+
+		// Add child element with specified name. Returns added node, or empty node on errors.
+		xml_node append_child(const char_t* name);
+		xml_node prepend_child(const char_t* name);
+		xml_node insert_child_after(const char_t* name, const xml_node& node);
+		xml_node insert_child_before(const char_t* name, const xml_node& node);
+
+		// Add a copy of the specified node as a child. Returns added node, or empty node on errors.
+		xml_node append_copy(const xml_node& proto);
+		xml_node prepend_copy(const xml_node& proto);
+		xml_node insert_copy_after(const xml_node& proto, const xml_node& node);
+		xml_node insert_copy_before(const xml_node& proto, const xml_node& node);
+
+		// Move the specified node to become a child of this node. Returns moved node, or empty node on errors.
+		xml_node append_move(const xml_node& moved);
+		xml_node prepend_move(const xml_node& moved);
+		xml_node insert_move_after(const xml_node& moved, const xml_node& node);
+		xml_node insert_move_before(const xml_node& moved, const xml_node& node);
+
+		// Remove specified attribute
+		bool remove_attribute(const xml_attribute& a);
+		bool remove_attribute(const char_t* name);
+
+		// Remove all attributes
+		bool remove_attributes();
+
+		// Remove specified child
+		bool remove_child(const xml_node& n);
+		bool remove_child(const char_t* name);
+
+		// Remove all children
+		bool remove_children();
+
+		// Parses buffer as an XML document fragment and appends all nodes as children of the current node.
+		// Copies/converts the buffer, so it may be deleted or changed after the function returns.
+		// Note: append_buffer allocates memory that has the lifetime of the owning document; removing the appended nodes does not immediately reclaim that memory.
+		xml_parse_result append_buffer(const void* contents, size_t size, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+
+		// Find attribute using predicate. Returns first attribute for which predicate returned true.
+		template <typename Predicate> xml_attribute find_attribute(Predicate pred) const
+		{
+			if (!_root) return xml_attribute();
+
+			for (xml_attribute attrib = first_attribute(); attrib; attrib = attrib.next_attribute())
+				if (pred(attrib))
+					return attrib;
+
+			return xml_attribute();
+		}
+
+		// Find child node using predicate. Returns first child for which predicate returned true.
+		template <typename Predicate> xml_node find_child(Predicate pred) const
+		{
+			if (!_root) return xml_node();
+
+			for (xml_node node = first_child(); node; node = node.next_sibling())
+				if (pred(node))
+					return node;
+
+			return xml_node();
+		}
+
+		// Find node from subtree using predicate. Returns first node from subtree (depth-first), for which predicate returned true.
+		template <typename Predicate> xml_node find_node(Predicate pred) const
+		{
+			if (!_root) return xml_node();
+
+			xml_node cur = first_child();
+
+			while (cur._root && cur._root != _root)
+			{
+				if (pred(cur)) return cur;
+
+				if (cur.first_child()) cur = cur.first_child();
+				else if (cur.next_sibling()) cur = cur.next_sibling();
+				else
+				{
+					while (!cur.next_sibling() && cur._root != _root) cur = cur.parent();
+
+					if (cur._root != _root) cur = cur.next_sibling();
+				}
+			}
+
+			return xml_node();
+		}
+
+		// Find child node by attribute name/value
+		xml_node find_child_by_attribute(const char_t* name, const char_t* attr_name, const char_t* attr_value) const;
+		xml_node find_child_by_attribute(const char_t* attr_name, const char_t* attr_value) const;
+
+	#ifndef PUGIXML_NO_STL
+		// Get the absolute node path from root as a text string.
+		string_t path(char_t delimiter = '/') const;
+	#endif
+
+		// Search for a node by path consisting of node names and . or .. elements.
+		xml_node first_element_by_path(const char_t* path, char_t delimiter = '/') const;
+
+		// Recursively traverse subtree with xml_tree_walker
+		bool traverse(xml_tree_walker& walker);
+
+	#ifndef PUGIXML_NO_XPATH
+		// Select single node by evaluating XPath query. Returns first node from the resulting node set.
+		xpath_node select_node(const char_t* query, xpath_variable_set* variables = PUGIXML_NULL) const;
+		xpath_node select_node(const xpath_query& query) const;
+
+		// Select node set by evaluating XPath query
+		xpath_node_set select_nodes(const char_t* query, xpath_variable_set* variables = PUGIXML_NULL) const;
+		xpath_node_set select_nodes(const xpath_query& query) const;
+
+		// (deprecated: use select_node instead) Select single node by evaluating XPath query.
+		PUGIXML_DEPRECATED xpath_node select_single_node(const char_t* query, xpath_variable_set* variables = PUGIXML_NULL) const;
+		PUGIXML_DEPRECATED xpath_node select_single_node(const xpath_query& query) const;
+
+	#endif
+
+		// Print subtree using a writer object
+		void print(xml_writer& writer, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto, unsigned int depth = 0) const;
+
+	#ifndef PUGIXML_NO_STL
+		// Print subtree to stream
+		void print(std::basic_ostream<char, std::char_traits<char> >& os, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto, unsigned int depth = 0) const;
+		void print(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& os, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, unsigned int depth = 0) const;
+	#endif
+
+		// Child nodes iterators
+		typedef xml_node_iterator iterator;
+
+		iterator begin() const;
+		iterator end() const;
+
+		// Attribute iterators
+		typedef xml_attribute_iterator attribute_iterator;
+
+		attribute_iterator attributes_begin() const;
+		attribute_iterator attributes_end() const;
+
+		// Range-based for support
+		xml_object_range<xml_node_iterator> children() const;
+		xml_object_range<xml_attribute_iterator> attributes() const;
+
+		// Range-based for support for all children with the specified name
+		// Note: name pointer must have a longer lifetime than the returned object; be careful with passing temporaries!
+		xml_object_range<xml_named_node_iterator> children(const char_t* name) const;
+
+		// Get node offset in parsed file/string (in char_t units) for debugging purposes
+		ptrdiff_t offset_debug() const;
+
+		// Get hash value (unique for handles to the same object)
+		size_t hash_value() const;
+
+		// Get internal pointer
+		xml_node_struct* internal_object() const;
+	};
+
+#ifdef __BORLANDC__
+	// Borland C++ workaround
+	bool PUGIXML_FUNCTION operator&&(const xml_node& lhs, bool rhs);
+	bool PUGIXML_FUNCTION operator||(const xml_node& lhs, bool rhs);
+#endif
+
+	// A helper for working with text inside PCDATA nodes
+	class PUGIXML_CLASS xml_text
+	{
+		friend class xml_node;
+
+		xml_node_struct* _root;
+
+		typedef void (*unspecified_bool_type)(xml_text***);
+
+		explicit xml_text(xml_node_struct* root);
+
+		xml_node_struct* _data_new();
+		xml_node_struct* _data() const;
+
+	public:
+		// Default constructor. Constructs an empty object.
+		xml_text();
+
+		// Safe bool conversion operator
+		operator unspecified_bool_type() const;
+
+		// Borland C++ workaround
+		bool operator!() const;
+
+		// Check if text object is empty
+		bool empty() const;
+
+		// Get text, or "" if object is empty
+		const char_t* get() const;
+
+		// Get text, or the default value if object is empty
+		const char_t* as_string(const char_t* def = PUGIXML_TEXT("")) const;
+
+		// Get text as a number, or the default value if conversion did not succeed or object is empty
+		int as_int(int def = 0) const;
+		unsigned int as_uint(unsigned int def = 0) const;
+		double as_double(double def = 0) const;
+		float as_float(float def = 0) const;
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		long long as_llong(long long def = 0) const;
+		unsigned long long as_ullong(unsigned long long def = 0) const;
+	#endif
+
+		// Get text as bool (returns true if first character is in '1tTyY' set), or the default value if object is empty
+		bool as_bool(bool def = false) const;
+
+		// Set text (returns false if object is empty or there is not enough memory)
+		bool set(const char_t* rhs);
+		bool set(const char_t* rhs, size_t size);
+
+		// Set text with type conversion (numbers are converted to strings, boolean is converted to "true"/"false")
+		bool set(int rhs);
+		bool set(unsigned int rhs);
+		bool set(long rhs);
+		bool set(unsigned long rhs);
+		bool set(double rhs);
+		bool set(double rhs, int precision);
+		bool set(float rhs);
+		bool set(float rhs, int precision);
+		bool set(bool rhs);
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		bool set(long long rhs);
+		bool set(unsigned long long rhs);
+	#endif
+
+		// Set text (equivalent to set without error checking)
+		xml_text& operator=(const char_t* rhs);
+		xml_text& operator=(int rhs);
+		xml_text& operator=(unsigned int rhs);
+		xml_text& operator=(long rhs);
+		xml_text& operator=(unsigned long rhs);
+		xml_text& operator=(double rhs);
+		xml_text& operator=(float rhs);
+		xml_text& operator=(bool rhs);
+
+	#ifdef PUGIXML_HAS_LONG_LONG
+		xml_text& operator=(long long rhs);
+		xml_text& operator=(unsigned long long rhs);
+	#endif
+
+		// Get the data node (node_pcdata or node_cdata) for this object
+		xml_node data() const;
+	};
+
+#ifdef __BORLANDC__
+	// Borland C++ workaround
+	bool PUGIXML_FUNCTION operator&&(const xml_text& lhs, bool rhs);
+	bool PUGIXML_FUNCTION operator||(const xml_text& lhs, bool rhs);
+#endif
+
+	// Child node iterator (a bidirectional iterator over a collection of xml_node)
+	class PUGIXML_CLASS xml_node_iterator
+	{
+		friend class xml_node;
+
+	private:
+		mutable xml_node _wrap;
+		xml_node _parent;
+
+		xml_node_iterator(xml_node_struct* ref, xml_node_struct* parent);
+
+	public:
+		// Iterator traits
+		typedef ptrdiff_t difference_type;
+		typedef xml_node value_type;
+		typedef xml_node* pointer;
+		typedef xml_node& reference;
+
+	#ifndef PUGIXML_NO_STL
+		typedef std::bidirectional_iterator_tag iterator_category;
+	#endif
+
+		// Default constructor
+		xml_node_iterator();
+
+		// Construct an iterator which points to the specified node
+		xml_node_iterator(const xml_node& node);
+
+		// Iterator operators
+		bool operator==(const xml_node_iterator& rhs) const;
+		bool operator!=(const xml_node_iterator& rhs) const;
+
+		xml_node& operator*() const;
+		xml_node* operator->() const;
+
+		xml_node_iterator& operator++();
+		xml_node_iterator operator++(int);
+
+		xml_node_iterator& operator--();
+		xml_node_iterator operator--(int);
+	};
+
+	// Attribute iterator (a bidirectional iterator over a collection of xml_attribute)
+	class PUGIXML_CLASS xml_attribute_iterator
+	{
+		friend class xml_node;
+
+	private:
+		mutable xml_attribute _wrap;
+		xml_node _parent;
+
+		xml_attribute_iterator(xml_attribute_struct* ref, xml_node_struct* parent);
+
+	public:
+		// Iterator traits
+		typedef ptrdiff_t difference_type;
+		typedef xml_attribute value_type;
+		typedef xml_attribute* pointer;
+		typedef xml_attribute& reference;
+
+	#ifndef PUGIXML_NO_STL
+		typedef std::bidirectional_iterator_tag iterator_category;
+	#endif
+
+		// Default constructor
+		xml_attribute_iterator();
+
+		// Construct an iterator which points to the specified attribute
+		xml_attribute_iterator(const xml_attribute& attr, const xml_node& parent);
+
+		// Iterator operators
+		bool operator==(const xml_attribute_iterator& rhs) const;
+		bool operator!=(const xml_attribute_iterator& rhs) const;
+
+		xml_attribute& operator*() const;
+		xml_attribute* operator->() const;
+
+		xml_attribute_iterator& operator++();
+		xml_attribute_iterator operator++(int);
+
+		xml_attribute_iterator& operator--();
+		xml_attribute_iterator operator--(int);
+	};
+
+	// Named node range helper
+	class PUGIXML_CLASS xml_named_node_iterator
+	{
+		friend class xml_node;
+
+	public:
+		// Iterator traits
+		typedef ptrdiff_t difference_type;
+		typedef xml_node value_type;
+		typedef xml_node* pointer;
+		typedef xml_node& reference;
+
+	#ifndef PUGIXML_NO_STL
+		typedef std::bidirectional_iterator_tag iterator_category;
+	#endif
+
+		// Default constructor
+		xml_named_node_iterator();
+
+		// Construct an iterator which points to the specified node
+		// Note: name pointer is stored in the iterator and must have a longer lifetime than iterator itself
+		xml_named_node_iterator(const xml_node& node, const char_t* name);
+
+		// Iterator operators
+		bool operator==(const xml_named_node_iterator& rhs) const;
+		bool operator!=(const xml_named_node_iterator& rhs) const;
+
+		xml_node& operator*() const;
+		xml_node* operator->() const;
+
+		xml_named_node_iterator& operator++();
+		xml_named_node_iterator operator++(int);
+
+		xml_named_node_iterator& operator--();
+		xml_named_node_iterator operator--(int);
+
+	private:
+		mutable xml_node _wrap;
+		xml_node _parent;
+		const char_t* _name;
+
+		xml_named_node_iterator(xml_node_struct* ref, xml_node_struct* parent, const char_t* name);
+	};
+
+	// Abstract tree walker class (see xml_node::traverse)
+	class PUGIXML_CLASS xml_tree_walker
+	{
+		friend class xml_node;
+
+	private:
+		int _depth;
+
+	protected:
+		// Get current traversal depth
+		int depth() const;
+
+	public:
+		xml_tree_walker();
+		virtual ~xml_tree_walker();
+
+		// Callback that is called when traversal begins
+		virtual bool begin(xml_node& node);
+
+		// Callback that is called for each node traversed
+		virtual bool for_each(xml_node& node) = 0;
+
+		// Callback that is called when traversal ends
+		virtual bool end(xml_node& node);
+	};
+
+	// Parsing status, returned as part of xml_parse_result object
+	enum xml_parse_status
+	{
+		status_ok = 0,				// No error
+
+		status_file_not_found,		// File was not found during load_file()
+		status_io_error,			// Error reading from file/stream
+		status_out_of_memory,		// Could not allocate memory
+		status_internal_error,		// Internal error occurred
+
+		status_unrecognized_tag,	// Parser could not determine tag type
+
+		status_bad_pi,				// Parsing error occurred while parsing document declaration/processing instruction
+		status_bad_comment,			// Parsing error occurred while parsing comment
+		status_bad_cdata,			// Parsing error occurred while parsing CDATA section
+		status_bad_doctype,			// Parsing error occurred while parsing document type declaration
+		status_bad_pcdata,			// Parsing error occurred while parsing PCDATA section
+		status_bad_start_element,	// Parsing error occurred while parsing start element tag
+		status_bad_attribute,		// Parsing error occurred while parsing element attribute
+		status_bad_end_element,		// Parsing error occurred while parsing end element tag
+		status_end_element_mismatch,// There was a mismatch of start-end tags (closing tag had incorrect name, some tag was not closed or there was an excessive closing tag)
+
+		status_append_invalid_root,	// Unable to append nodes since root type is not node_element or node_document (exclusive to xml_node::append_buffer)
+
+		status_no_document_element	// Parsing resulted in a document without element nodes
+	};
+
+	// Parsing result
+	struct PUGIXML_CLASS xml_parse_result
+	{
+		// Parsing status (see xml_parse_status)
+		xml_parse_status status;
+
+		// Last parsed offset (in char_t units from start of input data)
+		ptrdiff_t offset;
+
+		// Source document encoding
+		xml_encoding encoding;
+
+		// Default constructor, initializes object to failed state
+		xml_parse_result();
+
+		// Cast to bool operator
+		operator bool() const;
+
+		// Get error description
+		const char* description() const;
+	};
+
+	// Document class (DOM tree root)
+	class PUGIXML_CLASS xml_document: public xml_node
+	{
+	private:
+		char_t* _buffer;
+
+		char _memory[192];
+
+		// Non-copyable semantics
+		xml_document(const xml_document&);
+		xml_document& operator=(const xml_document&);
+
+		void _create();
+		void _destroy();
+		void _move(xml_document& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT;
+
+	public:
+		// Default constructor, makes empty document
+		xml_document();
+
+		// Destructor, invalidates all node/attribute handles to this document
+		~xml_document();
+
+	#ifdef PUGIXML_HAS_MOVE
+		// Move semantics support
+		xml_document(xml_document&& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT;
+		xml_document& operator=(xml_document&& rhs) PUGIXML_NOEXCEPT_IF_NOT_COMPACT;
+	#endif
+
+		// Removes all nodes, leaving the empty document
+		void reset();
+
+		// Removes all nodes, then copies the entire contents of the specified document
+		void reset(const xml_document& proto);
+
+	#ifndef PUGIXML_NO_STL
+		// Load document from stream.
+		xml_parse_result load(std::basic_istream<char, std::char_traits<char> >& stream, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+		xml_parse_result load(std::basic_istream<wchar_t, std::char_traits<wchar_t> >& stream, unsigned int options = parse_default);
+	#endif
+
+		// (deprecated: use load_string instead) Load document from zero-terminated string. No encoding conversions are applied.
+		PUGIXML_DEPRECATED xml_parse_result load(const char_t* contents, unsigned int options = parse_default);
+
+		// Load document from zero-terminated string. No encoding conversions are applied.
+		xml_parse_result load_string(const char_t* contents, unsigned int options = parse_default);
+
+		// Load document from file
+		xml_parse_result load_file(const char* path, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+		xml_parse_result load_file(const wchar_t* path, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+
+		// Load document from buffer. Copies/converts the buffer, so it may be deleted or changed after the function returns.
+		xml_parse_result load_buffer(const void* contents, size_t size, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+
+		// Load document from buffer, using the buffer for in-place parsing (the buffer is modified and used for storage of document data).
+		// You should ensure that buffer data will persist throughout the document's lifetime, and free the buffer memory manually once document is destroyed.
+		xml_parse_result load_buffer_inplace(void* contents, size_t size, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+
+		// Load document from buffer, using the buffer for in-place parsing (the buffer is modified and used for storage of document data).
+		// You should allocate the buffer with pugixml allocation function; document will free the buffer when it is no longer needed (you can't use it anymore).
+		xml_parse_result load_buffer_inplace_own(void* contents, size_t size, unsigned int options = parse_default, xml_encoding encoding = encoding_auto);
+
+		// Save XML document to writer (semantics is slightly different from xml_node::print, see documentation for details).
+		void save(xml_writer& writer, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto) const;
+
+	#ifndef PUGIXML_NO_STL
+		// Save XML document to stream (semantics is slightly different from xml_node::print, see documentation for details).
+		void save(std::basic_ostream<char, std::char_traits<char> >& stream, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto) const;
+		void save(std::basic_ostream<wchar_t, std::char_traits<wchar_t> >& stream, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default) const;
+	#endif
+
+		// Save XML to file
+		bool save_file(const char* path, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto) const;
+		bool save_file(const wchar_t* path, const char_t* indent = PUGIXML_TEXT("\t"), unsigned int flags = format_default, xml_encoding encoding = encoding_auto) const;
+
+		// Get document element
+		xml_node document_element() const;
+	};
+
+#ifndef PUGIXML_NO_XPATH
+	// XPath query return type
+	enum xpath_value_type
+	{
+		xpath_type_none,	  // Unknown type (query failed to compile)
+		xpath_type_node_set,  // Node set (xpath_node_set)
+		xpath_type_number,	  // Number
+		xpath_type_string,	  // String
+		xpath_type_boolean	  // Boolean
+	};
+
+	// XPath parsing result
+	struct PUGIXML_CLASS xpath_parse_result
+	{
+		// Error message (0 if no error)
+		const char* error;
+
+		// Last parsed offset (in char_t units from string start)
+		ptrdiff_t offset;
+
+		// Default constructor, initializes object to failed state
+		xpath_parse_result();
+
+		// Cast to bool operator
+		operator bool() const;
+
+		// Get error description
+		const char* description() const;
+	};
+
+	// A single XPath variable
+	class PUGIXML_CLASS xpath_variable
+	{
+		friend class xpath_variable_set;
+
+	protected:
+		xpath_value_type _type;
+		xpath_variable* _next;
+
+		xpath_variable(xpath_value_type type);
+
+		// Non-copyable semantics
+		xpath_variable(const xpath_variable&);
+		xpath_variable& operator=(const xpath_variable&);
+
+	public:
+		// Get variable name
+		const char_t* name() const;
+
+		// Get variable type
+		xpath_value_type type() const;
+
+		// Get variable value; no type conversion is performed, default value (false, NaN, empty string, empty node set) is returned on type mismatch error
+		bool get_boolean() const;
+		double get_number() const;
+		const char_t* get_string() const;
+		const xpath_node_set& get_node_set() const;
+
+		// Set variable value; no type conversion is performed, false is returned on type mismatch error
+		bool set(bool value);
+		bool set(double value);
+		bool set(const char_t* value);
+		bool set(const xpath_node_set& value);
+	};
+
+	// A set of XPath variables
+	class PUGIXML_CLASS xpath_variable_set
+	{
+	private:
+		xpath_variable* _data[64];
+
+		void _assign(const xpath_variable_set& rhs);
+		void _swap(xpath_variable_set& rhs);
+
+		xpath_variable* _find(const char_t* name) const;
+
+		static bool _clone(xpath_variable* var, xpath_variable** out_result);
+		static void _destroy(xpath_variable* var);
+
+	public:
+		// Default constructor/destructor
+		xpath_variable_set();
+		~xpath_variable_set();
+
+		// Copy constructor/assignment operator
+		xpath_variable_set(const xpath_variable_set& rhs);
+		xpath_variable_set& operator=(const xpath_variable_set& rhs);
+
+	#ifdef PUGIXML_HAS_MOVE
+		// Move semantics support
+		xpath_variable_set(xpath_variable_set&& rhs) PUGIXML_NOEXCEPT;
+		xpath_variable_set& operator=(xpath_variable_set&& rhs) PUGIXML_NOEXCEPT;
+	#endif
+
+		// Add a new variable or get the existing one, if the types match
+		xpath_variable* add(const char_t* name, xpath_value_type type);
+
+		// Set value of an existing variable; no type conversion is performed, false is returned if there is no such variable or if types mismatch
+		bool set(const char_t* name, bool value);
+		bool set(const char_t* name, double value);
+		bool set(const char_t* name, const char_t* value);
+		bool set(const char_t* name, const xpath_node_set& value);
+
+		// Get existing variable by name
+		xpath_variable* get(const char_t* name);
+		const xpath_variable* get(const char_t* name) const;
+	};
+
+	// A compiled XPath query object
+	class PUGIXML_CLASS xpath_query
+	{
+	private:
+		void* _impl;
+		xpath_parse_result _result;
+
+		typedef void (*unspecified_bool_type)(xpath_query***);
+
+		// Non-copyable semantics
+		xpath_query(const xpath_query&);
+		xpath_query& operator=(const xpath_query&);
+
+	public:
+		// Construct a compiled object from XPath expression.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws xpath_exception on compilation errors.
+		explicit xpath_query(const char_t* query, xpath_variable_set* variables = PUGIXML_NULL);
+
+		// Constructor
+		xpath_query();
+
+		// Destructor
+		~xpath_query();
+
+	#ifdef PUGIXML_HAS_MOVE
+		// Move semantics support
+		xpath_query(xpath_query&& rhs) PUGIXML_NOEXCEPT;
+		xpath_query& operator=(xpath_query&& rhs) PUGIXML_NOEXCEPT;
+	#endif
+
+		// Get query expression return type
+		xpath_value_type return_type() const;
+
+		// Evaluate expression as boolean value in the specified context; performs type conversion if necessary.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws std::bad_alloc on out of memory errors.
+		bool evaluate_boolean(const xpath_node& n) const;
+
+		// Evaluate expression as double value in the specified context; performs type conversion if necessary.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws std::bad_alloc on out of memory errors.
+		double evaluate_number(const xpath_node& n) const;
+
+	#ifndef PUGIXML_NO_STL
+		// Evaluate expression as string value in the specified context; performs type conversion if necessary.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws std::bad_alloc on out of memory errors.
+		string_t evaluate_string(const xpath_node& n) const;
+	#endif
+
+		// Evaluate expression as string value in the specified context; performs type conversion if necessary.
+		// At most capacity characters are written to the destination buffer, full result size is returned (includes terminating zero).
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws std::bad_alloc on out of memory errors.
+		// If PUGIXML_NO_EXCEPTIONS is defined, returns empty  set instead.
+		size_t evaluate_string(char_t* buffer, size_t capacity, const xpath_node& n) const;
+
+		// Evaluate expression as node set in the specified context.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws xpath_exception on type mismatch and std::bad_alloc on out of memory errors.
+		// If PUGIXML_NO_EXCEPTIONS is defined, returns empty node set instead.
+		xpath_node_set evaluate_node_set(const xpath_node& n) const;
+
+		// Evaluate expression as node set in the specified context.
+		// Return first node in document order, or empty node if node set is empty.
+		// If PUGIXML_NO_EXCEPTIONS is not defined, throws xpath_exception on type mismatch and std::bad_alloc on out of memory errors.
+		// If PUGIXML_NO_EXCEPTIONS is defined, returns empty node instead.
+		xpath_node evaluate_node(const xpath_node& n) const;
+
+		// Get parsing result (used to get compilation errors in PUGIXML_NO_EXCEPTIONS mode)
+		const xpath_parse_result& result() const;
+
+		// Safe bool conversion operator
+		operator unspecified_bool_type() const;
+
+		// Borland C++ workaround
+		bool operator!() const;
+	};
+
+	#ifndef PUGIXML_NO_EXCEPTIONS
+        #if defined(_MSC_VER)
+          // C4275 can be ignored in Visual C++ if you are deriving
+          // from a type in the Standard C++ Library
+          #pragma warning(push)
+          #pragma warning(disable: 4275)
+        #endif
+	// XPath exception class
+	class PUGIXML_CLASS xpath_exception: public std::exception
+	{
+	private:
+		xpath_parse_result _result;
+
+	public:
+		// Construct exception from parse result
+		explicit xpath_exception(const xpath_parse_result& result);
+
+		// Get error message
+		virtual const char* what() const throw() PUGIXML_OVERRIDE;
+
+		// Get parse result
+		const xpath_parse_result& result() const;
+	};
+        #if defined(_MSC_VER)
+          #pragma warning(pop)
+        #endif
+	#endif
+
+	// XPath node class (either xml_node or xml_attribute)
+	class PUGIXML_CLASS xpath_node
+	{
+	private:
+		xml_node _node;
+		xml_attribute _attribute;
+
+		typedef void (*unspecified_bool_type)(xpath_node***);
+
+	public:
+		// Default constructor; constructs empty XPath node
+		xpath_node();
+
+		// Construct XPath node from XML node/attribute
+		xpath_node(const xml_node& node);
+		xpath_node(const xml_attribute& attribute, const xml_node& parent);
+
+		// Get node/attribute, if any
+		xml_node node() const;
+		xml_attribute attribute() const;
+
+		// Get parent of contained node/attribute
+		xml_node parent() const;
+
+		// Safe bool conversion operator
+		operator unspecified_bool_type() const;
+
+		// Borland C++ workaround
+		bool operator!() const;
+
+		// Comparison operators
+		bool operator==(const xpath_node& n) const;
+		bool operator!=(const xpath_node& n) const;
+	};
+
+#ifdef __BORLANDC__
+	// Borland C++ workaround
+	bool PUGIXML_FUNCTION operator&&(const xpath_node& lhs, bool rhs);
+	bool PUGIXML_FUNCTION operator||(const xpath_node& lhs, bool rhs);
+#endif
+
+	// A fixed-size collection of XPath nodes
+	class PUGIXML_CLASS xpath_node_set
+	{
+	public:
+		// Collection type
+		enum type_t
+		{
+			type_unsorted,			// Not ordered
+			type_sorted,			// Sorted by document order (ascending)
+			type_sorted_reverse		// Sorted by document order (descending)
+		};
+
+		// Constant iterator type
+		typedef const xpath_node* const_iterator;
+
+		// We define non-constant iterator to be the same as constant iterator so that various generic algorithms (i.e. boost foreach) work
+		typedef const xpath_node* iterator;
+
+		// Default constructor. Constructs empty set.
+		xpath_node_set();
+
+		// Constructs a set from iterator range; data is not checked for duplicates and is not sorted according to provided type, so be careful
+		xpath_node_set(const_iterator begin, const_iterator end, type_t type = type_unsorted);
+
+		// Destructor
+		~xpath_node_set();
+
+		// Copy constructor/assignment operator
+		xpath_node_set(const xpath_node_set& ns);
+		xpath_node_set& operator=(const xpath_node_set& ns);
+
+	#ifdef PUGIXML_HAS_MOVE
+		// Move semantics support
+		xpath_node_set(xpath_node_set&& rhs) PUGIXML_NOEXCEPT;
+		xpath_node_set& operator=(xpath_node_set&& rhs) PUGIXML_NOEXCEPT;
+	#endif
+
+		// Get collection type
+		type_t type() const;
+
+		// Get collection size
+		size_t size() const;
+
+		// Indexing operator
+		const xpath_node& operator[](size_t index) const;
+
+		// Collection iterators
+		const_iterator begin() const;
+		const_iterator end() const;
+
+		// Sort the collection in ascending/descending order by document order
+		void sort(bool reverse = false);
+
+		// Get first node in the collection by document order
+		xpath_node first() const;
+
+		// Check if collection is empty
+		bool empty() const;
+
+	private:
+		type_t _type;
+
+		xpath_node _storage[1];
+
+		xpath_node* _begin;
+		xpath_node* _end;
+
+		void _assign(const_iterator begin, const_iterator end, type_t type);
+		void _move(xpath_node_set& rhs) PUGIXML_NOEXCEPT;
+	};
+#endif
+
+#ifndef PUGIXML_NO_STL
+	// Convert wide string to UTF8
+	std::basic_string<char, std::char_traits<char>, std::allocator<char> > PUGIXML_FUNCTION as_utf8(const wchar_t* str);
+	std::basic_string<char, std::char_traits<char>, std::allocator<char> > PUGIXML_FUNCTION as_utf8(const std::basic_string<wchar_t, std::char_traits<wchar_t>, std::allocator<wchar_t> >& str);
+
+	// Convert UTF8 to wide string
+	std::basic_string<wchar_t, std::char_traits<wchar_t>, std::allocator<wchar_t> > PUGIXML_FUNCTION as_wide(const char* str);
+	std::basic_string<wchar_t, std::char_traits<wchar_t>, std::allocator<wchar_t> > PUGIXML_FUNCTION as_wide(const std::basic_string<char, std::char_traits<char>, std::allocator<char> >& str);
+#endif
+
+	// Memory allocation function interface; returns pointer to allocated memory or NULL on failure
+	typedef void* (*allocation_function)(size_t size);
+
+	// Memory deallocation function interface
+	typedef void (*deallocation_function)(void* ptr);
+
+	// Override default memory management functions. All subsequent allocations/deallocations will be performed via supplied functions.
+	void PUGIXML_FUNCTION set_memory_management_functions(allocation_function allocate, deallocation_function deallocate);
+
+	// Get current memory management functions
+	allocation_function PUGIXML_FUNCTION get_memory_allocation_function();
+	deallocation_function PUGIXML_FUNCTION get_memory_deallocation_function();
+}
+
+#if !defined(PUGIXML_NO_STL) && (defined(_MSC_VER) || defined(__ICC))
+namespace std
+{
+	// Workarounds for (non-standard) iterator category detection for older versions (MSVC7/IC8 and earlier)
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION _Iter_cat(const pugi::xml_node_iterator&);
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION _Iter_cat(const pugi::xml_attribute_iterator&);
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION _Iter_cat(const pugi::xml_named_node_iterator&);
+}
+#endif
+
+#if !defined(PUGIXML_NO_STL) && defined(__SUNPRO_CC)
+namespace std
+{
+	// Workarounds for (non-standard) iterator category detection
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION __iterator_category(const pugi::xml_node_iterator&);
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION __iterator_category(const pugi::xml_attribute_iterator&);
+	std::bidirectional_iterator_tag PUGIXML_FUNCTION __iterator_category(const pugi::xml_named_node_iterator&);
+}
+#endif
+
+#endif
+
+// Make sure implementation is included in header-only mode
+// Use macro expansion in #include to work around QMake (QTBUG-11923)
+#if defined(PUGIXML_HEADER_ONLY) && !defined(PUGIXML_SOURCE)
+#	define PUGIXML_SOURCE "pugixml.cpp"
+#	include PUGIXML_SOURCE
+#endif
+
+/**
+ * Copyright (c) 2006-2023 Arseny Kapoulkine
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ */

+ 371 - 0
pico-tcp-service/pico-tcp/simplelogger.cpp

@@ -0,0 +1,371 @@
+#include "simplelogger.hpp"
+
+// Generates filename (in format prefix-log-data-time)
+
+std::string SimpleLogger::generateFileName()
+{
+    std::chrono::time_point<std::chrono::system_clock> time_now = std::chrono::system_clock::now();
+    std::time_t t_n = std::chrono::system_clock::to_time_t(time_now);
+
+    char logfile_creation_time[100];
+    std::strftime(logfile_creation_time, sizeof(logfile_creation_time), "%Y%m%d-%H%M%S", std::localtime(&t_n));
+    std::string logname = this->log_name_prefix + "-log-" + std::string(logfile_creation_time) + ".log";
+
+    std::cout << logname << std::endl;
+
+    return logname;
+}
+
+// Generates prefix (in format of [TIME] / [FLAG]) for log string
+
+std::string SimpleLogger::generateLogString(int flag = INFO)
+{
+    auto time = std::chrono::system_clock::now(); // get the current time
+    std::time_t t = std::chrono::system_clock::to_time_t(time);
+
+    char log_time[100];
+    std::strftime(log_time, sizeof(log_time), "%Y-%m-%d %H:%M:%S", std::localtime(&t));
+
+    auto since_epoch = time.time_since_epoch(); // get the duration since epoch
+
+    auto time_millis = std::chrono::duration_cast<std::chrono::milliseconds>(since_epoch);
+    auto time_seconds = std::chrono::duration_cast<std::chrono::seconds>(since_epoch);
+
+    unsigned long long millis = time_millis.count() - 1000*time_seconds.count();
+
+    std::string logstring = std::string("[") + std::string(log_time) + std::string(":") + std::to_string(millis) + std::string("]");
+
+    // Different flags
+    switch(flag)
+    {
+    case ERROR:
+        logstring = logstring + " / [ERROR]\t";
+        break;
+    case DEBUG_ERROR:
+        logstring = logstring + " / [ERROR]\t";
+        break;
+    case DONE:
+        logstring = logstring + " / [DONE]\t";
+        break;
+    case WARN:
+        logstring = logstring + " / [WARN]\t";
+        break;
+    case INFO:
+        logstring = logstring + " / [INFO]\t";
+        break;
+    case OK:
+        logstring = logstring + " / [OK]\t";
+        break;
+    case DEBUG:
+        logstring = logstring + " / [DEBUG]\t";
+        break;
+    default:
+        logstring = logstring + " / [UNDEF]\t";
+        break;
+    }
+
+    return logstring;
+}
+
+// Main Constructors (we need to send reference to our main log stream)
+
+SimpleLogger::SimpleLogger(std::ostream& ls = std::cout, std::string prefix = "", std::string dir = "") : log_stream(ls)
+{
+    this->initializeLogger(dir, prefix);
+}
+
+SimpleLogger::SimpleLogger(std::ostream& ls = std::cout) : log_stream(ls)
+{
+    this->initializeLogger("", "some");
+}
+
+SimpleLogger::SimpleLogger(std::ostream& ls, std::string prefix) : log_stream(ls)
+{
+    this->initializeLogger("", prefix);
+}
+
+// Initialize function
+
+void SimpleLogger::initializeLogger(std::string dir = "", std::string prefix = "")
+{
+    this->log_flag.flag = INFO;
+
+    if(dir != "")
+    {
+    #ifdef _WIN32
+    CreateDirectoryA(dir.c_str(), NULL);
+    this->log_name_prefix = dir + std::string("\\") + prefix;
+    #endif // _WIN32
+
+    #if defined(_LINUX)
+    mkdir(dir.c_str(), 0777);
+    this->log_name_prefix = dir + std::string("/") +prefix;
+    #endif // defined
+    }
+    else
+    {
+        this->log_name_prefix = prefix;
+    }
+
+    this->log_string = "";
+    this->console_enabled = false;
+
+    this->log_name = generateFileName();
+
+    this->file_stream.open(this->log_name);
+    this->log_stream.rdbuf(this->file_stream.rdbuf());
+}
+
+// Copy logger constructor
+
+SimpleLogger::SimpleLogger(const SimpleLogger& other) : log_stream(other.log_stream)
+{
+    this->log_flag = other.log_flag;
+    this->log_name_prefix = other.log_name_prefix;
+    this->log_string = other.log_string;
+    this->console_enabled = other.console_enabled;
+    this->log_name = other.log_name;
+}
+
+// Close logger stream
+
+void SimpleLogger::closeLogger()
+{
+    this->file_stream.close();
+}
+
+// Destructor
+
+SimpleLogger::~SimpleLogger()
+{
+    this->closeLogger();
+}
+
+// Setting logger flag
+
+void SimpleLogger::setLoggerFlag(LogPref::Flag log_flag = LogPref::Flag(INFO))
+{
+    this->log_flag = log_flag;
+}
+
+// Setting ability to console output
+
+void SimpleLogger::enableConsoleOutput(bool enable_console)
+{
+    console_enabled = enable_console;
+}
+
+// Sets flag just for one record;
+
+SimpleLogger SimpleLogger::operator<<(LogPref::Flag flag)
+{
+    SimpleLogger s(*this);
+    s.setLoggerFlag(flag);
+    return s;
+}
+
+// Shift operators (follow standard ostream shift operators)
+
+SimpleLogger SimpleLogger::operator<<(bool val){
+    // Firstly printing in console
+    if(console_enabled){
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    // Printing in file
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned long long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(double val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long double val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const void* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::nullptr_t) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << "nullptr";
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << "nullptr";
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(short val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(int val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned short val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned int val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(float val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::streambuf *sb) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << sb;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << sb;;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::ios_base& (*func)(std::ios_base&)) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::ostream& (*func)(std::ostream&)) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::_Setfill<char> func)
+{
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::_Setw func)
+{
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::string val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const signed char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const unsigned char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const char val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const unsigned char val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}

+ 100 - 0
pico-tcp-service/pico-tcp/simplelogger.hpp

@@ -0,0 +1,100 @@
+#include <iostream>
+#include <iomanip>
+#include <chrono>
+#include <ctime>
+#include <sstream>
+#include <fstream>
+#include <sstream>
+#include <fstream>
+
+#if _WIN32
+
+#include <windows.h>
+#include <winbase.h>
+
+#endif // _WIN32
+
+#if defined(_LINUX)
+
+#include <sys/stat.h>
+#include <unistd.h>
+
+#endif // defined
+
+#define ERROR -1 // Logger flags
+#define DEBUG_ERROR 6
+#define WARN 1
+#define INFO 0
+#define OK 4
+#define DEBUG 7
+#define DONE 10
+#define NO_LOG_STRING 2
+
+#ifndef SIMPLELOGGER_HPP
+#define SIMPLELOGGER_HPP
+
+namespace LogPref
+{
+class Flag {
+public:
+    int flag;
+    Flag(int flag) {this->flag = flag;}
+    Flag() {this->flag = INFO;}
+};
+}
+
+class SimpleLogger {
+
+protected:
+    std::ostream& log_stream;
+    std::ofstream file_stream;
+
+    std::string log_name;
+    std::string log_name_prefix;
+    std::string log_string;
+    LogPref::Flag log_flag;
+    bool console_enabled;
+
+    std::string generateFileName();
+    std::string generateLogString(int flag);
+
+public:
+    SimpleLogger(std::ostream& ls, std::string prefix, std::string dir);
+    SimpleLogger(std::ostream& ls, std::string prefix);
+    SimpleLogger(std::ostream& ls);
+    SimpleLogger(const SimpleLogger& other);
+    void initializeLogger(std::string filename, std::string prefix);
+    void closeLogger();
+    void enableConsoleOutput(bool enable_console);
+    void setLoggerFlag(LogPref::Flag log_flag);
+    ~SimpleLogger();
+
+    SimpleLogger operator<<(LogPref::Flag flag);
+    SimpleLogger operator<<(bool val);
+    SimpleLogger operator<<(long val);
+    SimpleLogger operator<<(unsigned long val);
+    SimpleLogger operator<<(long long val);
+    SimpleLogger operator<<(unsigned long long val);
+    SimpleLogger operator<<(double val);
+    SimpleLogger operator<<(long double val);
+    SimpleLogger operator<<(const void* val);
+    SimpleLogger operator<<(std::nullptr_t);
+    SimpleLogger operator<<(short val);
+    SimpleLogger operator<<(int val);
+    SimpleLogger operator<<(unsigned short val);
+    SimpleLogger operator<<(unsigned int val);
+    SimpleLogger operator<<(float val);
+    SimpleLogger operator<<(std::streambuf *sb);
+    SimpleLogger operator<<(std::ios_base& (*func)(std::ios_base&));
+    SimpleLogger operator<<(std::ostream& (*func)(std::ostream&));
+    SimpleLogger operator<<(std::_Setfill<char> func);
+    SimpleLogger operator<<(std::_Setw func);
+    SimpleLogger operator<<(std::string val);
+    SimpleLogger operator<<(const char* val);
+    SimpleLogger operator<<(const signed char* val);
+    SimpleLogger operator<<(const unsigned char* val);
+    SimpleLogger operator<<(const char val);
+    SimpleLogger operator<<(const unsigned char val);
+};
+
+#endif // SIMPLELOGGER_HPP

+ 310 - 0
pico-tcp-service/pico-tcp/src/ActiveSocket.cpp

@@ -0,0 +1,310 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* CActiveSocket.cpp - Active Socket Implementation                          */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#include "ActiveSocket.h"
+
+CActiveSocket::CActiveSocket(CSocketType nType) : CSimpleSocket(nType)
+{
+}
+
+//------------------------------------------------------------------------------
+//
+// ConnectTCP() -
+//
+//------------------------------------------------------------------------------
+bool CActiveSocket::ConnectTCP(const char *pAddr, uint16 nPort)
+{
+    bool           bRetVal = false;
+    struct in_addr stIpAddress;
+
+    //------------------------------------------------------------------
+    // Preconnection setup that must be preformed
+    //------------------------------------------------------------------
+    memset(&m_stServerSockaddr, 0, sizeof(m_stServerSockaddr));
+    m_stServerSockaddr.sin_family = AF_INET;
+
+    if ((m_pHE = GETHOSTBYNAME(pAddr)) == NULL)
+    {
+#ifdef WIN32
+        TranslateSocketError();
+#else
+        if (h_errno == HOST_NOT_FOUND)
+        {
+            SetSocketError(SocketInvalidAddress);
+        }
+#endif
+        return bRetVal;
+    }
+
+    memcpy(&stIpAddress, m_pHE->h_addr_list[0], m_pHE->h_length);
+    m_stServerSockaddr.sin_addr.s_addr = stIpAddress.s_addr;
+
+    if ((int32)m_stServerSockaddr.sin_addr.s_addr == CSimpleSocket::SocketError)
+    {
+        TranslateSocketError();
+        return bRetVal;
+    }
+
+    m_stServerSockaddr.sin_port = htons(nPort);
+
+    //------------------------------------------------------------------
+    // Connect to address "xxx.xxx.xxx.xxx"    (IPv4) address only.
+    //
+    //------------------------------------------------------------------
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+    if (connect(m_socket, (struct sockaddr*)&m_stServerSockaddr, sizeof(m_stServerSockaddr)) ==
+            CSimpleSocket::SocketError)
+    {
+        //--------------------------------------------------------------
+        // Get error value this might be a non-blocking socket so we
+        // must first check.
+        //--------------------------------------------------------------
+        TranslateSocketError();
+
+        //--------------------------------------------------------------
+        // If the socket is non-blocking and the current socket error
+        // is SocketEinprogress or SocketEwouldblock then poll connection
+        // with select for designated timeout period.
+        // Linux returns EINPROGRESS and Windows returns WSAEWOULDBLOCK.
+        //--------------------------------------------------------------
+        if ((IsNonblocking()) &&
+                ((GetSocketError() == CSimpleSocket::SocketEwouldblock) ||
+                 (GetSocketError() == CSimpleSocket::SocketEinprogress)))
+        {
+            bRetVal = Select(GetConnectTimeoutSec(), GetConnectTimeoutUSec());
+        }
+    }
+    else
+    {
+        TranslateSocketError();
+        bRetVal = true;
+    }
+
+    m_timer.SetEndTime();
+
+    return bRetVal;
+}
+
+//------------------------------------------------------------------------------
+//
+// ConnectUDP() -
+//
+//------------------------------------------------------------------------------
+bool CActiveSocket::ConnectUDP(const char *pAddr, uint16 nPort)
+{
+    bool           bRetVal = false;
+    struct in_addr stIpAddress;
+
+    //------------------------------------------------------------------
+    // Pre-connection setup that must be preformed
+    //------------------------------------------------------------------
+    memset(&m_stServerSockaddr, 0, sizeof(m_stServerSockaddr));
+    m_stServerSockaddr.sin_family = AF_INET;
+
+    if ((m_pHE = GETHOSTBYNAME(pAddr)) == NULL)
+    {
+#ifdef WIN32
+        TranslateSocketError();
+#else
+        if (h_errno == HOST_NOT_FOUND)
+        {
+            SetSocketError(SocketInvalidAddress);
+        }
+#endif
+        return bRetVal;
+    }
+
+    memcpy(&stIpAddress, m_pHE->h_addr_list[0], m_pHE->h_length);
+    m_stServerSockaddr.sin_addr.s_addr = stIpAddress.s_addr;
+
+    if ((int32)m_stServerSockaddr.sin_addr.s_addr == CSimpleSocket::SocketError)
+    {
+        TranslateSocketError();
+        return bRetVal;
+    }
+
+    m_stServerSockaddr.sin_port = htons(nPort);
+
+    //------------------------------------------------------------------
+    // Connect to address "xxx.xxx.xxx.xxx"    (IPv4) address only.
+    //
+    //------------------------------------------------------------------
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+    if (connect(m_socket, (struct sockaddr*)&m_stServerSockaddr, sizeof(m_stServerSockaddr)) != CSimpleSocket::SocketError)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    m_timer.SetEndTime();
+
+    return bRetVal;
+}
+
+//------------------------------------------------------------------------------
+//
+// ConnectRAW() -
+//
+//------------------------------------------------------------------------------
+bool CActiveSocket::ConnectRAW(const char *pAddr, uint16 nPort)
+{
+    bool           bRetVal = false;
+    struct in_addr stIpAddress;
+    //------------------------------------------------------------------
+    // Pre-connection setup that must be preformed
+    //------------------------------------------------------------------
+    memset(&m_stServerSockaddr, 0, sizeof(m_stServerSockaddr));
+    m_stServerSockaddr.sin_family = AF_INET;
+
+    if ((m_pHE = GETHOSTBYNAME(pAddr)) == NULL)
+    {
+#ifdef WIN32
+        TranslateSocketError();
+#else
+        if (h_errno == HOST_NOT_FOUND)
+        {
+            SetSocketError(SocketInvalidAddress);
+        }
+#endif
+        return bRetVal;
+    }
+
+    memcpy(&stIpAddress, m_pHE->h_addr_list[0], m_pHE->h_length);
+    m_stServerSockaddr.sin_addr.s_addr = stIpAddress.s_addr;
+
+    if ((int32)m_stServerSockaddr.sin_addr.s_addr == CSimpleSocket::SocketError)
+    {
+        TranslateSocketError();
+        return bRetVal;
+    }
+
+    m_stServerSockaddr.sin_port = htons(nPort);
+
+    //------------------------------------------------------------------
+    // Connect to address "xxx.xxx.xxx.xxx"    (IPv4) address only.
+    //
+    //------------------------------------------------------------------
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+    if (connect(m_socket, (struct sockaddr*)&m_stServerSockaddr, sizeof(m_stServerSockaddr)) != CSimpleSocket::SocketError)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    m_timer.SetEndTime();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Open() - Create a connection to a specified address on a specified port
+//
+//------------------------------------------------------------------------------
+bool CActiveSocket::Open(const char *pAddr, uint16 nPort)
+{
+    bool bRetVal = false;
+
+    if (IsSocketValid() == false)
+    {
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+        return bRetVal;
+    }
+
+    if (pAddr == NULL)
+    {
+        SetSocketError(CSimpleSocket::SocketInvalidAddress);
+        return bRetVal;
+    }
+
+    if (nPort == 0)
+    {
+        SetSocketError(CSimpleSocket::SocketInvalidPort);
+        return bRetVal;
+    }
+
+    switch (m_nSocketType)
+    {
+    case CSimpleSocket::SocketTypeTcp :
+    {
+        bRetVal = ConnectTCP(pAddr, nPort);
+        break;
+    }
+    case CSimpleSocket::SocketTypeUdp :
+    {
+        bRetVal = ConnectUDP(pAddr, nPort);
+        break;
+    }
+    case CSimpleSocket::SocketTypeRaw :
+        break;
+    default:
+        break;
+    }
+
+    //--------------------------------------------------------------------------
+    // If successful then create a local copy of the address and port
+    //--------------------------------------------------------------------------
+    if (bRetVal)
+    {
+        socklen_t nSockLen = sizeof(struct sockaddr);
+
+        memset(&m_stServerSockaddr, 0, nSockLen);
+        getpeername(m_socket, (struct sockaddr *)&m_stServerSockaddr, &nSockLen);
+
+        nSockLen = sizeof(struct sockaddr);
+        memset(&m_stClientSockaddr, 0, nSockLen);
+        getsockname(m_socket, (struct sockaddr *)&m_stClientSockaddr, &nSockLen);
+
+        SetSocketError(SocketSuccess);
+    }
+
+    return bRetVal;
+}

+ 91 - 0
pico-tcp-service/pico-tcp/src/ActiveSocket.h

@@ -0,0 +1,91 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* ActiveSocket.h - Active Socket Decleration                                */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#ifndef __ACTIVESOCKET_H__
+#define __ACTIVESOCKET_H__
+
+#include "SimpleSocket.h"
+
+class CPassiveSocket;
+
+/// Provides a platform independent class to create an active socket.
+/// An active socket is used to create a socket which connects to a server.
+/// This type of object would be used when an application needs to send/receive
+/// data from a server.
+class EXPORT CActiveSocket : public CSimpleSocket {
+public:
+    friend class CPassiveSocket;
+
+    CActiveSocket(CSocketType type = SocketTypeTcp);
+    virtual ~CActiveSocket() {
+        Close();
+    };
+
+    /// Established a connection to the address specified by pAddr.
+    /// Connection-based protocol sockets (CSocket::SocketTypeTcp) may
+    /// successfully call Open() only once, however; connectionless protocol
+    /// sockets (CSocket::SocketTypeUdp) may use Open() multiple times to
+    /// change their association.
+    ///  @param pAddr specifies the destination address to connect.
+    ///  @param nPort specifies the destination port.
+    ///  @return true if successful connection made, otherwise false.
+    virtual bool Open(const char *pAddr, uint16 nPort);
+
+private:
+    /// Utility function used to create a TCP connection, called from Open().
+    ///  @return true if successful connection made, otherwise false.
+    bool ConnectTCP(const char *pAddr, uint16 nPort);
+
+    /// Utility function used to create a UDP connection, called from Open().
+    ///  @return true if successful connection made, otherwise false.
+    bool ConnectUDP(const char *pAddr, uint16 nPort);
+
+    /// Utility function used to create a RAW connection, called from Open().
+    ///  @return true if successful connection made, otherwise false.
+    bool ConnectRAW(const char *pAddr, uint16 nPort);
+
+private:
+    struct hostent *m_pHE;
+};
+
+#endif /*  __ACTIVESOCKET_H__  */
+

+ 263 - 0
pico-tcp-service/pico-tcp/src/Host.h

@@ -0,0 +1,263 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* Host.h - Basic header file to provide cross-platform solutions via        */
+/*                   macros, conditional compilation, etc.                   */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#ifndef __HOST_H__
+#define __HOST_H__
+
+#include <limits.h>
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* Type Definition Macros                                                    */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+#ifndef __WORDSIZE
+  /* Assume 32 */
+  #define __WORDSIZE 32
+#endif
+
+#if defined(_LINUX) || defined(_DARWIN)
+    typedef unsigned char  uint8;
+    typedef char           int8;
+    typedef unsigned short uint16;
+    typedef short          int16;
+    typedef unsigned int   uint32;
+    typedef int            int32;
+    typedef int            SOCKET;
+#endif
+
+#ifdef WIN32
+    struct iovec {
+        void  *iov_base;
+        size_t iov_len;
+    };
+
+    typedef unsigned char  uint8;
+    typedef char           int8;
+    typedef unsigned short uint16;
+    typedef short          int16;
+    typedef unsigned int   uint32;
+    typedef int            int32;
+#endif
+
+#ifdef WIN32
+    typedef int socklen_t;
+#endif
+
+#if defined(WIN32)
+    typedef unsigned long long int uint64;
+    typedef long long int          int64;
+#elif (__WORDSIZE == 32)
+    __extension__
+    typedef long long int          int64;
+    __extension__
+    typedef unsigned long long int uint64;
+#elif (__WORDSIZE == 64)
+    typedef unsigned long int uint64;
+    typedef long int          int64;
+#endif
+
+#ifdef WIN32
+
+  #ifndef UINT8_MAX
+    #define UINT8_MAX  (UCHAR_MAX)
+  #endif
+  #ifndef UINT16_MAX
+    #define UINT16_MAX (USHRT_MAX)
+  #endif
+  #ifndef UINT32_MAX
+    #define UINT32_MAX (ULONG_MAX)
+  #endif
+
+  #if __WORDSIZE == 64
+    #define SIZE_MAX (18446744073709551615UL)
+  #else
+    #ifndef SIZE_MAX
+    #define SIZE_MAX (4294967295U)
+  #endif
+  #endif
+#endif
+
+#if defined(WIN32)
+  #define ssize_t size_t
+#endif
+
+#ifndef TRUE
+  #define TRUE 1
+#endif
+
+#ifndef FALSE
+  #define FALSE 0
+#endif
+
+#ifndef htonll
+#ifdef _BIG_ENDIAN
+#define htonll(x)   (x)
+#define ntohll(x)   (x)
+#else
+#define htonll(x)   ((((uint64)htonl(x)) << 32) + htonl(x >> 32))
+#define ntohll(x)   ((((uint64)ntohl(x)) << 32) + ntohl(x >> 32))
+#endif
+#endif
+
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* Socket Macros                                                             */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+#ifdef WIN32
+#define SHUT_RD                0
+#define SHUT_WR                1
+#define SHUT_RDWR              2
+#define ACCEPT(a,b,c)          accept(a,b,c)
+#define CONNECT(a,b,c)         connect(a,b,c)
+#define CLOSE(a)               closesocket(a)
+#define READ(a,b,c)            read(a,b,c)
+#define RECV(a,b,c,d)          recv(a, (char *)b, c, d)
+#define RECVFROM(a,b,c,d,e,f)  recvfrom(a, (char *)b, c, d, (sockaddr *)e, (int *)f)
+#define RECV_FLAGS             MSG_WAITALL
+#define SELECT(a,b,c,d,e)      select((int32)a,b,c,d,e)
+#define SEND(a,b,c,d)          send(a, (const char *)b, (int)c, d)
+#define SENDTO(a,b,c,d,e,f)    sendto(a, (const char *)b, (int)c, d, e, f)
+#define SEND_FLAGS             0
+#define SENDFILE(a,b,c,d)      sendfile(a, b, c, d)
+#define SET_SOCKET_ERROR(x,y)  errno=y
+#define SOCKET_ERROR_INTERUPT  EINTR
+#define SOCKET_ERROR_TIMEDOUT  EAGAIN
+#define WRITE(a,b,c)           write(a,b,c)
+#define WRITEV(a,b,c)          Writev(b, c)
+#define GETSOCKOPT(a,b,c,d,e)  getsockopt(a,b,c,(char *)d, (int *)e)
+#define SETSOCKOPT(a,b,c,d,e)  setsockopt(a,b,c,(char *)d, (int)e)
+#define GETHOSTBYNAME(a)       gethostbyname(a)
+#endif
+
+#if defined(_LINUX) || defined(_DARWIN)
+#define ACCEPT(a,b,c)          accept(a,b,c)
+#define CONNECT(a,b,c)         connect(a,b,c)
+#define CLOSE(a)               close(a)
+#define READ(a,b,c)            read(a,b,c)
+#define RECV(a,b,c,d)          recv(a, (void *)b, c, d)
+#define RECVFROM(a,b,c,d,e,f)  recvfrom(a, (char *)b, c, d, (sockaddr *)e, f)
+#define RECV_FLAGS             MSG_WAITALL
+#define SELECT(a,b,c,d,e)      select(a,b,c,d,e)
+#define SEND(a,b,c,d)          send(a, (const int8 *)b, c, d)
+#define SENDTO(a,b,c,d,e,f)    sendto(a, (const int8 *)b, c, d, e, f)
+#define SEND_FLAGS             0
+#define SENDFILE(a,b,c,d)      sendfile(a, b, c, d)
+#define SET_SOCKET_ERROR(x,y)  errno=y
+#define SOCKET_ERROR_INTERUPT  EINTR
+#define SOCKET_ERROR_TIMEDOUT  EAGAIN
+#define WRITE(a,b,c)           write(a,b,c)
+#define WRITEV(a,b,c)          writev(a, b, c)
+#define GETSOCKOPT(a,b,c,d,e)  getsockopt((int)a,(int)b,(int)c,(void *)d,(socklen_t *)e)
+#define SETSOCKOPT(a,b,c,d,e)  setsockopt((int)a,(int)b,(int)c,(const void *)d,(int)e)
+#define GETHOSTBYNAME(a)       gethostbyname(a)
+#endif
+
+
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* File Macros                                                               */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+#define STRUCT_STAT         struct stat
+#define LSTAT(x,y)          lstat(x,y)
+#define FILE_HANDLE         FILE *
+#define CLEARERR(x)         clearerr(x)
+#define FCLOSE(x)           fclose(x)
+#define FEOF(x)             feof(x)
+#define FERROR(x)           ferror(x)
+#define FFLUSH(x)           fflush(x)
+#define FILENO(s)           fileno(s)
+#define FOPEN(x,y)          fopen(x, y)
+  //#define FREAD(a,b,c,d)      fread(a, b, c, d)
+#define FSTAT(s, st)        fstat(FILENO(s), st)
+    //#define FWRITE(a,b,c,d)     fwrite(a, b, c, d)
+#define STAT_BLK_SIZE(x)    ((x).st_blksize)
+
+
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* Misc Macros                                                               */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+#if defined(WIN32)
+  #define GET_CLOCK_COUNT(x) QueryPerformanceCounter((LARGE_INTEGER *)x)
+#else
+  #define GET_CLOCK_COUNT(x) gettimeofday(x, NULL)
+#endif
+
+#if defined(WIN32)
+  #define STRTOULL(x) _atoi64(x)
+#else
+  #define STRTOULL(x) strtoull(x, NULL, 10)
+#endif
+
+#if defined(WIN32)
+  #define SNPRINTF _snprintf
+  #define PRINTF   printf
+  #define VPRINTF  vprintf
+  #define FPRINTF  fprintf
+#else
+  #define SNPRINTF snprintf
+  #define PRINTF   printf
+  #define VPRINTF  vprintf
+  #define FPRINTF  fprintf
+#endif
+
+#ifdef _MSC_VER
+  #define EXPORT __declspec(dllexport)
+#else
+  #define EXPORT
+#endif
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __HOST_H__ */

+ 328 - 0
pico-tcp-service/pico-tcp/src/PassiveSocket.cpp

@@ -0,0 +1,328 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* PassiveSocket.cpp - Passive Socket Implementation                         */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#include "PassiveSocket.h"
+
+
+
+CPassiveSocket::CPassiveSocket(CSocketType nType) : CSimpleSocket(nType)
+{
+}
+
+bool CPassiveSocket::BindMulticast(const char *pInterface, const char *pGroup, uint16 nPort)
+{
+    bool           bRetVal = false;
+#ifdef WIN32
+    ULONG          inAddr;
+#else
+    in_addr_t      inAddr;
+#endif
+
+    //--------------------------------------------------------------------------
+    // Set the following socket option SO_REUSEADDR.  This will allow the file
+    // descriptor to be reused immediately after the socket is closed instead
+    // of setting in a TIMED_WAIT state.
+    //--------------------------------------------------------------------------
+    memset(&m_stMulticastGroup,0,sizeof(m_stMulticastGroup));
+    m_stMulticastGroup.sin_family = AF_INET;
+    m_stMulticastGroup.sin_port = htons(nPort);
+
+    //--------------------------------------------------------------------------
+    // If no IP Address (interface ethn) is supplied, or the loop back is
+    // specified then bind to any interface, else bind to specified interface.
+    //--------------------------------------------------------------------------
+    if ((pInterface == NULL) || (!strlen(pInterface)))
+    {
+        m_stMulticastGroup.sin_addr.s_addr = htonl(INADDR_ANY);
+    }
+    else
+    {
+        if ((inAddr = inet_addr(pInterface)) != INADDR_NONE)
+        {
+            m_stMulticastGroup.sin_addr.s_addr = inAddr;
+        }
+    }
+
+    //--------------------------------------------------------------------------
+    // Bind to the specified port
+    //--------------------------------------------------------------------------
+    if (bind(m_socket, (struct sockaddr *)&m_stMulticastGroup, sizeof(m_stMulticastGroup)) == 0)
+    {
+        //----------------------------------------------------------------------
+        // Join the multicast group
+        //----------------------------------------------------------------------
+        m_stMulticastRequest.imr_multiaddr.s_addr = inet_addr(pGroup);
+        m_stMulticastRequest.imr_interface.s_addr = m_stMulticastGroup.sin_addr.s_addr;
+
+        if (SETSOCKOPT(m_socket, IPPROTO_IP, IP_ADD_MEMBERSHIP,
+                       (void *)&m_stMulticastRequest,
+                       sizeof(m_stMulticastRequest)) == CSimpleSocket::SocketSuccess)
+        {
+            bRetVal = true;
+        }
+
+        m_timer.SetEndTime();
+    }
+
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+
+    //--------------------------------------------------------------------------
+    // If there was a socket error then close the socket to clean out the
+    // connection in the backlog.
+    //--------------------------------------------------------------------------
+    TranslateSocketError();
+
+    if (bRetVal == false)
+    {
+        Close();
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Listen() -
+//
+//------------------------------------------------------------------------------
+bool CPassiveSocket::Listen(const char *pAddr, uint16 nPort, int32 nConnectionBacklog)
+{
+    bool           bRetVal = false;
+#ifdef WIN32
+    ULONG          inAddr;
+#else
+    in_addr_t      inAddr;
+
+    int32          nReuse;
+    nReuse = IPTOS_LOWDELAY;
+
+    //--------------------------------------------------------------------------
+    // Set the following socket option SO_REUSEADDR.  This will allow the file
+    // descriptor to be reused immediately after the socket is closed instead
+    // of setting in a TIMED_WAIT state.
+    //--------------------------------------------------------------------------
+    SETSOCKOPT(m_socket, SOL_SOCKET, SO_REUSEADDR, (char*)&nReuse, sizeof(int32));
+    SETSOCKOPT(m_socket, IPPROTO_TCP, IP_TOS, &nReuse, sizeof(int32));
+#endif
+
+    memset(&m_stServerSockaddr,0,sizeof(m_stServerSockaddr));
+    m_stServerSockaddr.sin_family = AF_INET;
+    m_stServerSockaddr.sin_port = htons(nPort);
+
+    //--------------------------------------------------------------------------
+    // If no IP Address (interface ethn) is supplied, or the loop back is
+    // specified then bind to any interface, else bind to specified interface.
+    //--------------------------------------------------------------------------
+    if ((pAddr == NULL) || (!strlen(pAddr)))
+    {
+        m_stServerSockaddr.sin_addr.s_addr = htonl(INADDR_ANY);
+    }
+    else
+    {
+        if ((inAddr = inet_addr(pAddr)) != INADDR_NONE)
+        {
+            m_stServerSockaddr.sin_addr.s_addr = inAddr;
+        }
+    }
+
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+    //--------------------------------------------------------------------------
+    // Bind to the specified port
+    //--------------------------------------------------------------------------
+    if (bind(m_socket, (struct sockaddr *)&m_stServerSockaddr, sizeof(m_stServerSockaddr)) != CSimpleSocket::SocketError)
+    {
+        if (m_nSocketType == CSimpleSocket::SocketTypeTcp)
+        {
+            if (listen(m_socket, nConnectionBacklog) != CSimpleSocket::SocketError)
+            {
+                bRetVal = true;
+            }
+        }
+        else
+        {
+            bRetVal = true;
+        }
+    }
+
+    m_timer.SetEndTime();
+
+    //--------------------------------------------------------------------------
+    // If there was a socket error then close the socket to clean out the
+    // connection in the backlog.
+    //--------------------------------------------------------------------------
+    TranslateSocketError();
+
+    if (bRetVal == false)
+    {
+        CSocketError err = GetSocketError();
+        Close();
+        SetSocketError(err);
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Accept() -
+//
+//------------------------------------------------------------------------------
+CActiveSocket *CPassiveSocket::Accept()
+{
+    uint32         nSockLen;
+    CActiveSocket *pClientSocket = NULL;
+    SOCKET         socket = CSimpleSocket::SocketError;
+
+    if (m_nSocketType != CSimpleSocket::SocketTypeTcp)
+    {
+        SetSocketError(CSimpleSocket::SocketProtocolError);
+        return pClientSocket;
+    }
+
+    pClientSocket = new CActiveSocket();
+
+    //--------------------------------------------------------------------------
+    // Wait for incoming connection.
+    //--------------------------------------------------------------------------
+    if (pClientSocket != NULL)
+    {
+        CSocketError socketErrno = SocketSuccess;
+
+        m_timer.Initialize();
+        m_timer.SetStartTime();
+
+        nSockLen = sizeof(m_stClientSockaddr);
+
+        do
+        {
+            errno = 0;
+            socket = accept(m_socket, (struct sockaddr *)&m_stClientSockaddr, (socklen_t *)&nSockLen);
+
+            if (socket != -1)
+            {
+                pClientSocket->SetSocketHandle(socket);
+                pClientSocket->TranslateSocketError();
+                socketErrno = pClientSocket->GetSocketError();
+                socklen_t nSockLen = sizeof(struct sockaddr);
+
+                //-------------------------------------------------------------
+                // Store client and server IP and port information for this
+                // connection.
+                //-------------------------------------------------------------
+                getpeername(m_socket, (struct sockaddr *)&pClientSocket->m_stClientSockaddr, &nSockLen);
+                memcpy((void *)&pClientSocket->m_stClientSockaddr, (void *)&m_stClientSockaddr, nSockLen);
+
+                memset(&pClientSocket->m_stServerSockaddr, 0, nSockLen);
+                getsockname(m_socket, (struct sockaddr *)&pClientSocket->m_stServerSockaddr, &nSockLen);
+            }
+            else
+            {
+                TranslateSocketError();
+                socketErrno = GetSocketError();
+            }
+
+        } while (socketErrno == CSimpleSocket::SocketInterrupted);
+
+        m_timer.SetEndTime();
+
+        if (socketErrno != CSimpleSocket::SocketSuccess)
+        {
+            delete pClientSocket;
+            pClientSocket = NULL;
+        }
+    }
+
+    return pClientSocket;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Send() - Send data on a valid socket
+//
+//------------------------------------------------------------------------------
+int32 CPassiveSocket::Send(const uint8 *pBuf, size_t bytesToSend)
+{
+    SetSocketError(SocketSuccess);
+    m_nBytesSent = 0;
+
+    switch(m_nSocketType)
+    {
+    case CSimpleSocket::SocketTypeUdp:
+    {
+        if (IsSocketValid())
+        {
+            if ((bytesToSend > 0) && (pBuf != NULL))
+            {
+                m_timer.Initialize();
+                m_timer.SetStartTime();
+
+                m_nBytesSent = SENDTO(m_socket, pBuf, bytesToSend, 0,
+                                      (const sockaddr *)&m_stClientSockaddr,
+                                      sizeof(m_stClientSockaddr));
+
+                m_timer.SetEndTime();
+
+                if (m_nBytesSent == CSimpleSocket::SocketError)
+                {
+                    TranslateSocketError();
+                }
+            }
+        }
+        break;
+    }
+    case CSimpleSocket::SocketTypeTcp:
+        CSimpleSocket::Send(pBuf, bytesToSend);
+        break;
+    default:
+        SetSocketError(SocketProtocolError);
+        break;
+    }
+
+    return m_nBytesSent;
+}

+ 119 - 0
pico-tcp-service/pico-tcp/src/PassiveSocket.h

@@ -0,0 +1,119 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* Socket.h - Passive Socket Decleration.                                    */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#ifndef __PASSIVESOCKET_H__
+#define __PASSIVESOCKET_H__
+#include "ActiveSocket.h"
+
+/// Provides a platform independent class to create a passive socket.
+/// A passive socket is used to create a "listening" socket.  This type
+/// of object would be used when an application needs to wait for
+/// inbound connections.  Support for CSimpleSocket::SocketTypeTcp,
+/// CSimpleSocket::SocketTypeUdp, and CSimpleSocket::SocketTypeRaw is handled
+/// in a similar fashion.  The big difference is that the method
+/// CPassiveSocket::Accept should not be called on the latter two socket
+/// types.
+class EXPORT CPassiveSocket : public CSimpleSocket {
+public:
+    CPassiveSocket(CSocketType type = SocketTypeTcp);
+    virtual ~CPassiveSocket() {
+        Close();
+    };
+
+    /// Extracts the first connection request on the queue of pending
+    /// connections and creates a newly connected socket.  Used with
+    /// CSocketType CSimpleSocket::SocketTypeTcp.  It is the responsibility of
+    /// the caller to delete the returned object when finished.
+    ///  @return if successful a pointer to a newly created CActiveSocket object
+    ///          will be returned and the internal error condition of the CPassiveSocket
+    ///          object will be CPassiveSocket::SocketSuccess.  If an error condition was encountered
+    ///          the NULL will be returned and one of the following error conditions will be set:
+    ///    CPassiveSocket::SocketEwouldblock, CPassiveSocket::SocketInvalidSocket,
+    ///    CPassiveSocket::SocketConnectionAborted, CPassiveSocket::SocketInterrupted
+    ///    CPassiveSocket::SocketProtocolError, CPassiveSocket::SocketFirewallError
+    virtual CActiveSocket *Accept(void);
+
+    /// Bind to a multicast group on  a specified interface, multicast group, and port
+    ///
+    ///  @param pInterface - interface on which to bind.
+    ///  @param pGroup - multicast group address to bind.
+    ///  @param nPort - port on which multicast
+    ///  @return true if able to bind to interface and multicast group.
+    ///      If not successful, the false is returned and one of the following error
+    ///      condiitions will be set: CPassiveSocket::SocketAddressInUse, CPassiveSocket::SocketProtocolError,
+    ///      CPassiveSocket::SocketInvalidSocket.  The following socket errors are for Linux/Unix
+    ///      derived systems only: CPassiveSocket::SocketInvalidSocketBuffer
+    bool BindMulticast(const char *pInterface, const char *pGroup, uint16 nPort);
+
+    /// Create a listening socket at local ip address 'x.x.x.x' or 'localhost'
+    /// if pAddr is NULL on port nPort.
+    ///
+    ///  @param pAddr specifies the IP address on which to listen.
+    ///  @param nPort specifies the port on which to listen.
+    ///  @param nConnectionBacklog specifies connection queue backlog (default 30,000)
+    ///  @return true if a listening socket was created.
+    ///      If not successful, the false is returned and one of the following error
+    ///      conditions will be set: CPassiveSocket::SocketAddressInUse, CPassiveSocket::SocketProtocolError,
+    ///      CPassiveSocket::SocketInvalidSocket.  The following socket errors are for Linux/Unix
+    ///      derived systems only: CPassiveSocket::SocketInvalidSocketBuffer
+    virtual bool Listen(const char *pAddr, uint16 nPort, int32 nConnectionBacklog = 30000);
+
+    /// Attempts to send a block of data on an established connection.
+    /// @param pBuf block of data to be sent.
+    /// @param bytesToSend size of data block to be sent.
+    /// @return number of bytes actually sent, return of zero means the
+    /// connection has been shutdown on the other side, and a return of -1
+    /// means that an error has occurred.  If an error was signaled then one
+    /// of the following error codes will be set: CPassiveSocket::SocketInvalidSocket,
+    /// CPassiveSocket::SocketEwouldblock, SimpleSocket::SocketConnectionReset,
+    /// CPassiveSocket::SocketInvalidSocketBuffer, CPassiveSocket::SocketInterrupted,
+    /// CPassiveSocket::SocketProtocolError, CPassiveSocket::SocketNotconnected
+    /// <br>\b Note: This function is used only for a socket of type
+    /// CSimpleSocket::SocketTypeUdp
+    virtual int32 Send(const uint8 *pBuf, size_t bytesToSend);
+
+private:
+    struct ip_mreq  m_stMulticastRequest;   /// group address for multicast
+
+};
+
+#endif // __PASSIVESOCKET_H__

+ 1189 - 0
pico-tcp-service/pico-tcp/src/SimpleSocket.cpp

@@ -0,0 +1,1189 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* CSimpleSocket.cpp - CSimpleSocket Implementation                          */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#include "SimpleSocket.h"
+
+CSimpleSocket::CSimpleSocket(CSocketType nType) :
+    m_socket(INVALID_SOCKET),
+    m_socketErrno(CSimpleSocket::SocketInvalidSocket),
+    m_pBuffer(NULL), m_nBufferSize(0), m_nSocketDomain(AF_INET),
+    m_nSocketType(SocketTypeInvalid), m_nBytesReceived(-1),
+    m_nBytesSent(-1), m_nFlags(0),
+    m_bIsBlocking(true), m_bIsMulticast(false)
+{
+    SetConnectTimeout(1, 0);
+    memset(&m_stRecvTimeout, 0, sizeof(struct timeval));
+    memset(&m_stSendTimeout, 0, sizeof(struct timeval));
+    memset(&m_stLinger, 0, sizeof(struct linger));
+
+    switch(nType)
+    {
+        //----------------------------------------------------------------------
+        // Declare socket type stream - TCP
+        //----------------------------------------------------------------------
+    case CSimpleSocket::SocketTypeTcp:
+    {
+        m_nSocketDomain = AF_INET;
+        m_nSocketType = CSimpleSocket::SocketTypeTcp;
+        break;
+    }
+    case CSimpleSocket::SocketTypeTcp6:
+    {
+        m_nSocketDomain = AF_INET6;
+        m_nSocketType = CSimpleSocket::SocketTypeTcp6;
+        break;
+    }
+    //----------------------------------------------------------------------
+    // Declare socket type datagram - UDP
+    //----------------------------------------------------------------------
+    case CSimpleSocket::SocketTypeUdp:
+    {
+        m_nSocketDomain = AF_INET;
+        m_nSocketType = CSimpleSocket::SocketTypeUdp;
+        break;
+    }
+    case CSimpleSocket::SocketTypeUdp6:
+    {
+        m_nSocketDomain = AF_INET6;
+        m_nSocketType = CSimpleSocket::SocketTypeUdp6;
+        break;
+    }
+    //----------------------------------------------------------------------
+    // Declare socket type raw Ethernet - Ethernet
+    //----------------------------------------------------------------------
+    case CSimpleSocket::SocketTypeRaw:
+    {
+#if defined(_LINUX) && !defined(_DARWIN)
+        m_nSocketDomain = AF_PACKET;
+        m_nSocketType = CSimpleSocket::SocketTypeRaw;
+#endif
+#ifdef _WIN32
+        m_nSocketType = CSimpleSocket::SocketTypeInvalid;
+#endif
+        break;
+    }
+    default:
+        m_nSocketType = CSimpleSocket::SocketTypeInvalid;
+        break;
+    }
+}
+
+CSimpleSocket::CSimpleSocket(CSimpleSocket &socket)
+{
+    m_pBuffer = new uint8[socket.m_nBufferSize];
+    m_nBufferSize = socket.m_nBufferSize;
+    memcpy(m_pBuffer, socket.m_pBuffer, socket.m_nBufferSize);
+}
+
+CSimpleSocket *CSimpleSocket::operator=(CSimpleSocket &socket)
+{
+    if (m_nBufferSize != socket.m_nBufferSize)
+    {
+        delete m_pBuffer;
+        m_pBuffer = new uint8[socket.m_nBufferSize];
+        m_nBufferSize = socket.m_nBufferSize;
+        memcpy(m_pBuffer, socket.m_pBuffer, socket.m_nBufferSize);
+    }
+
+    return this;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Initialize() - Initialize socket class
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::Initialize()
+{
+    errno = CSimpleSocket::SocketSuccess;
+
+#ifdef WIN32
+    //-------------------------------------------------------------------------
+    // Data structure containing general Windows Sockets Info
+    //-------------------------------------------------------------------------
+    memset(&m_hWSAData, 0, sizeof(m_hWSAData));
+    WSAStartup(MAKEWORD(2, 0), &m_hWSAData);
+#endif
+
+    //-------------------------------------------------------------------------
+    // Create the basic Socket Handle
+    //-------------------------------------------------------------------------
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+    m_socket = socket(m_nSocketDomain, m_nSocketType, 0);
+    m_timer.SetEndTime();
+
+    TranslateSocketError();
+
+    return (IsSocketValid());
+}
+
+
+//------------------------------------------------------------------------------
+//
+// BindInterface()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::BindInterface(const char *pInterface)
+{
+    bool           bRetVal = false;
+    struct in_addr stInterfaceAddr;
+
+    if (GetMulticast() == true)
+    {
+        if (pInterface)
+        {
+            stInterfaceAddr.s_addr= inet_addr(pInterface);
+            if (SETSOCKOPT(m_socket, IPPROTO_IP, IP_MULTICAST_IF, &stInterfaceAddr, sizeof(stInterfaceAddr)) == SocketSuccess)
+            {
+                bRetVal = true;
+            }
+        }
+    }
+    else
+    {
+        SetSocketError(CSimpleSocket::SocketProtocolError);
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetMulticast()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetMulticast(bool bEnable, uint8 multicastTTL)
+{
+    bool bRetVal = false;
+
+    if (GetSocketType() == CSimpleSocket::SocketTypeUdp)
+    {
+        m_bIsMulticast = bEnable;
+        if (SETSOCKOPT(m_socket, IPPROTO_IP, IP_MULTICAST_TTL, (void *)&multicastTTL, sizeof(multicastTTL)) == SocketError)
+        {
+            TranslateSocketError();
+            bRetVal = false;
+        }
+        else
+        {
+            bRetVal = true;
+        }
+    }
+    else
+    {
+        m_socketErrno = CSimpleSocket::SocketProtocolError;
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetSocketDscp()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetSocketDscp(int32 nDscp)
+{
+    bool  bRetVal = true;
+    int32 nTempVal = nDscp;
+
+    nTempVal <<= 4;
+    nTempVal /= 4;
+
+    if (IsSocketValid())
+    {
+        if (SETSOCKOPT(m_socket, IPPROTO_IP, IP_TOS, &nTempVal, sizeof(nTempVal)) == SocketError)
+        {
+            TranslateSocketError();
+            bRetVal = false;
+        }
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// GetSocketDscp()
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::GetSocketDscp(void)
+{
+    int32      nTempVal = 0;
+    socklen_t  nLen = 0;
+
+    if (IsSocketValid())
+    {
+        if (GETSOCKOPT(m_socket, IPPROTO_IP, IP_TOS, &nTempVal, &nLen) == SocketError)
+        {
+            TranslateSocketError();
+        }
+
+        nTempVal *= 4;
+        nTempVal >>= 4;
+    }
+
+    return nTempVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// GetWindowSize()
+//
+//------------------------------------------------------------------------------
+uint32 CSimpleSocket::GetWindowSize(uint32 nOptionName)
+{
+    uint32 nTcpWinSize = 0;
+
+    //-------------------------------------------------------------------------
+    // no socket given, return system default allocate our own new socket
+    //-------------------------------------------------------------------------
+    if (m_socket != CSimpleSocket::SocketError)
+    {
+        socklen_t nLen = sizeof(nTcpWinSize);
+
+        //---------------------------------------------------------------------
+        // query for buffer size
+        //---------------------------------------------------------------------
+        GETSOCKOPT(m_socket, SOL_SOCKET, nOptionName, &nTcpWinSize, &nLen);
+        TranslateSocketError();
+    }
+    else
+    {
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+    }
+
+    return nTcpWinSize;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetWindowSize()
+//
+//------------------------------------------------------------------------------
+uint32 CSimpleSocket::SetWindowSize(uint32 nOptionName, uint32 nWindowSize)
+{
+    //-------------------------------------------------------------------------
+    // no socket given, return system default allocate our own new socket
+    //-------------------------------------------------------------------------
+    if (m_socket != CSimpleSocket::SocketError)
+    {
+        SETSOCKOPT(m_socket, SOL_SOCKET, nOptionName, &nWindowSize, sizeof(nWindowSize));
+        TranslateSocketError();
+    }
+    else
+    {
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+    }
+
+    return nWindowSize;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// DisableNagleAlgorithm()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::DisableNagleAlgoritm()
+{
+    bool  bRetVal = false;
+    int32 nTcpNoDelay = 1;
+
+    //----------------------------------------------------------------------
+    // Set TCP NoDelay flag to true
+    //----------------------------------------------------------------------
+    if (SETSOCKOPT(m_socket, IPPROTO_TCP, TCP_NODELAY, &nTcpNoDelay, sizeof(int32)) == 0)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// EnableNagleAlgorithm()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::EnableNagleAlgoritm()
+{
+    bool  bRetVal = false;
+    int32 nTcpNoDelay = 0;
+
+    //----------------------------------------------------------------------
+    // Set TCP NoDelay flag to false
+    //----------------------------------------------------------------------
+    if (SETSOCKOPT(m_socket, IPPROTO_TCP, TCP_NODELAY, &nTcpNoDelay, sizeof(int32)) == 0)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Send() - Send data on a valid socket
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::Send(const uint8 *pBuf, size_t bytesToSend)
+{
+    SetSocketError(SocketSuccess);
+    m_nBytesSent = 0;
+
+    switch(m_nSocketType)
+    {
+    case CSimpleSocket::SocketTypeTcp:
+    {
+        if (IsSocketValid())
+        {
+            if ((bytesToSend > 0) && (pBuf != NULL))
+            {
+                m_timer.Initialize();
+                m_timer.SetStartTime();
+
+                //---------------------------------------------------------
+                // Check error condition and attempt to resend if call
+                // was interrupted by a signal.
+                //---------------------------------------------------------
+                do
+                {
+                    m_nBytesSent = SEND(m_socket, pBuf, bytesToSend, 0);
+                    TranslateSocketError();
+                } while (GetSocketError() == CSimpleSocket::SocketInterrupted);
+
+                m_timer.SetEndTime();
+            }
+        }
+        break;
+    }
+    case CSimpleSocket::SocketTypeUdp:
+    {
+        if (IsSocketValid())
+        {
+            if ((bytesToSend > 0) && (pBuf != NULL))
+            {
+                m_timer.Initialize();
+                m_timer.SetStartTime();
+
+                //---------------------------------------------------------
+                // Check error condition and attempt to resend if call
+                // was interrupted by a signal.
+                //---------------------------------------------------------
+                //                    if (GetMulticast())
+                //                    {
+                //                        do
+                //                        {
+                //                            m_nBytesSent = SENDTO(m_socket, pBuf, bytesToSend, 0, (const sockaddr *)&m_stMulticastGroup,
+                //                                                  sizeof(m_stMulticastGroup));
+                //                            TranslateSocketError();
+                //                        } while (GetSocketError() == CSimpleSocket::SocketInterrupted);
+                //                    }
+                //                    else
+                {
+                    do
+                    {
+                        m_nBytesSent = SENDTO(m_socket, pBuf, bytesToSend, 0, (const sockaddr *)&m_stServerSockaddr, sizeof(m_stServerSockaddr));
+                        TranslateSocketError();
+                    } while (GetSocketError() == CSimpleSocket::SocketInterrupted);
+                }
+
+                m_timer.SetEndTime();
+            }
+        }
+        break;
+    }
+    default:
+        break;
+    }
+
+    return m_nBytesSent;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Close() - Close socket and free up any memory allocated for the socket
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::Close(void)
+{
+    bool bRetVal = false;
+
+    //--------------------------------------------------------------------------
+    // delete internal buffer
+    //--------------------------------------------------------------------------
+    if (m_pBuffer != NULL)
+    {
+        delete [] m_pBuffer;
+        m_pBuffer = NULL;
+    }
+
+    //--------------------------------------------------------------------------
+    // if socket handle is currently valid, close and then invalidate
+    //--------------------------------------------------------------------------
+    if (IsSocketValid())
+    {
+        if (CLOSE(m_socket) != CSimpleSocket::SocketError)
+        {
+            m_socket = INVALID_SOCKET;
+            bRetVal = true;
+        }
+    }
+
+    TranslateSocketError();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Shtudown()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::Shutdown(CShutdownMode nShutdown)
+{
+    CSocketError nRetVal = SocketEunknown;
+
+    nRetVal = (CSocketError)shutdown(m_socket, nShutdown);
+    TranslateSocketError();
+
+    return (nRetVal == CSimpleSocket::SocketSuccess) ? true: false;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Flush()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::Flush()
+{
+    int32 nTcpNoDelay = 1;
+    int32 nCurFlags = 0;
+    uint8 tmpbuf = 0;
+    bool  bRetVal = false;
+
+    //--------------------------------------------------------------------------
+    // Get the current setting of the TCP_NODELAY flag.
+    //--------------------------------------------------------------------------
+    if (GETSOCKOPT(m_socket, IPPROTO_TCP, TCP_NODELAY, &nCurFlags, sizeof(int32)) == 0)
+    {
+        //----------------------------------------------------------------------
+        // Set TCP NoDelay flag
+        //----------------------------------------------------------------------
+        if (SETSOCKOPT(m_socket, IPPROTO_TCP, TCP_NODELAY, &nTcpNoDelay, sizeof(int32)) == 0)
+        {
+            //------------------------------------------------------------------
+            // Send empty byte stream to flush the TCP send buffer
+            //------------------------------------------------------------------
+            if (Send(&tmpbuf, 0) != CSimpleSocket::SocketError)
+            {
+                bRetVal = true;
+            }
+
+            TranslateSocketError();
+        }
+
+        //----------------------------------------------------------------------
+        // Reset the TCP_NODELAY flag to original state.
+        //----------------------------------------------------------------------
+        SETSOCKOPT(m_socket, IPPROTO_TCP, TCP_NODELAY, &nCurFlags, sizeof(int32));
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Writev -
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::Writev(const struct iovec *pVector, size_t nCount)
+{
+    int32 nBytes     = 0;
+    int32 nBytesSent = 0;
+    int32 i          = 0;
+
+    //--------------------------------------------------------------------------
+    // Send each buffer as a separate send, windows does not support this
+    // function call.
+    //--------------------------------------------------------------------------
+    for (i = 0; i < (int32)nCount; i++)
+    {
+        if ((nBytes = Send((uint8 *)pVector[i].iov_base, pVector[i].iov_len)) == CSimpleSocket::SocketError)
+        {
+            break;
+        }
+
+        nBytesSent += nBytes;
+    }
+
+    if (i > 0)
+    {
+        Flush();
+    }
+
+    return nBytesSent;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Send() - Send data on a valid socket via a vector of buffers.
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::Send(const struct iovec *sendVector, int32 nNumItems)
+{
+    SetSocketError(SocketSuccess);
+    m_nBytesSent = 0;
+
+    if ((m_nBytesSent = WRITEV(m_socket, sendVector, nNumItems)) == CSimpleSocket::SocketError)
+    {
+        TranslateSocketError();
+    }
+
+    return m_nBytesSent;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetReceiveTimeout()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetReceiveTimeout(int32 nRecvTimeoutSec, int32 nRecvTimeoutUsec)
+{
+    bool bRetVal = true;
+
+    memset(&m_stRecvTimeout, 0, sizeof(struct timeval));
+
+    m_stRecvTimeout.tv_sec = nRecvTimeoutSec;
+    m_stRecvTimeout.tv_usec = nRecvTimeoutUsec;
+
+    //--------------------------------------------------------------------------
+    // Sanity check to make sure the options are supported!
+    //--------------------------------------------------------------------------
+    if (SETSOCKOPT(m_socket, SOL_SOCKET, SO_RCVTIMEO, &m_stRecvTimeout,
+                   sizeof(struct timeval)) == CSimpleSocket::SocketError)
+    {
+        bRetVal = false;
+        TranslateSocketError();
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetSendTimeout()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetSendTimeout(int32 nSendTimeoutSec, int32 nSendTimeoutUsec)
+{
+    bool bRetVal = true;
+
+    memset(&m_stSendTimeout, 0, sizeof(struct timeval));
+    m_stSendTimeout.tv_sec = nSendTimeoutSec;
+    m_stSendTimeout.tv_usec = nSendTimeoutUsec;
+
+    //--------------------------------------------------------------------------
+    // Sanity check to make sure the options are supported!
+    //--------------------------------------------------------------------------
+    if (SETSOCKOPT(m_socket, SOL_SOCKET, SO_SNDTIMEO, &m_stSendTimeout,
+                   sizeof(struct timeval)) == CSimpleSocket::SocketError)
+    {
+        bRetVal = false;
+        TranslateSocketError();
+    }
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetOptionReuseAddr()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetOptionReuseAddr()
+{
+    bool  bRetVal = false;
+    int32 nReuse  = IPTOS_LOWDELAY;
+
+    if (SETSOCKOPT(m_socket, SOL_SOCKET, SO_REUSEADDR, (char*)&nReuse, sizeof(int32)) == 0)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetOptionLinger()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetOptionLinger(bool bEnable, uint16 nTime)
+{
+    bool bRetVal = false;
+
+    m_stLinger.l_onoff = (bEnable == true) ? 1: 0;
+    m_stLinger.l_linger = nTime;
+
+    if (SETSOCKOPT(m_socket, SOL_SOCKET, SO_LINGER, &m_stLinger, sizeof(m_stLinger)) == 0)
+    {
+        bRetVal = true;
+    }
+
+    TranslateSocketError();
+
+    return bRetVal;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// Receive() - Attempts to receive a block of data on an established
+//             connection.    Data is received in an internal buffer managed
+//             by the class.  This buffer is only valid until the next call
+//             to Receive(), a call to Close(), or until the object goes out
+//             of scope.
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::Receive(int32 nMaxBytes, uint8 * pBuffer )
+{
+    m_nBytesReceived = 0;
+
+    //--------------------------------------------------------------------------
+    // If the socket is invalid then return false.
+    //--------------------------------------------------------------------------
+    if (IsSocketValid() == false)
+    {
+        return m_nBytesReceived;
+    }
+
+    uint8 * pWorkBuffer = pBuffer;
+    if ( pBuffer == NULL )
+    {
+        //--------------------------------------------------------------------------
+        // Free existing buffer and allocate a new buffer the size of
+        // nMaxBytes.
+        //--------------------------------------------------------------------------
+        if ((m_pBuffer != NULL) && (nMaxBytes != m_nBufferSize))
+        {
+            delete [] m_pBuffer;
+            m_pBuffer = NULL;
+        }
+
+        //--------------------------------------------------------------------------
+        // Allocate a new internal buffer to receive data.
+        //--------------------------------------------------------------------------
+        if (m_pBuffer == NULL)
+        {
+            m_nBufferSize = nMaxBytes;
+            m_pBuffer = new uint8[nMaxBytes];
+        }
+
+        pWorkBuffer = m_pBuffer;
+    }
+
+    SetSocketError(SocketSuccess);
+
+    m_timer.Initialize();
+    m_timer.SetStartTime();
+
+    switch (m_nSocketType)
+    {
+        //----------------------------------------------------------------------
+        // If zero bytes are received, then return.  If SocketERROR is
+        // received, free buffer and return CSocket::SocketError (-1) to caller.
+        //----------------------------------------------------------------------
+    case CSimpleSocket::SocketTypeTcp:
+    {
+        do
+        {
+            m_nBytesReceived = RECV(m_socket, (pWorkBuffer + m_nBytesReceived),
+                                    nMaxBytes, m_nFlags);
+            TranslateSocketError();
+        } while ((GetSocketError() == CSimpleSocket::SocketInterrupted));
+
+        break;
+    }
+    case CSimpleSocket::SocketTypeUdp:
+    {
+        uint32 srcSize;
+
+        srcSize = sizeof(struct sockaddr_in);
+
+        if (GetMulticast() == true)
+        {
+            do
+            {
+                m_nBytesReceived = RECVFROM(m_socket, pWorkBuffer, nMaxBytes, 0,
+                                            &m_stMulticastGroup, &srcSize);
+                TranslateSocketError();
+            } while (GetSocketError() == CSimpleSocket::SocketInterrupted);
+        }
+        else
+        {
+            do
+            {
+                m_nBytesReceived = RECVFROM(m_socket, pWorkBuffer, nMaxBytes, 0,
+                                            &m_stClientSockaddr, &srcSize);
+                TranslateSocketError();
+            } while (GetSocketError() == CSimpleSocket::SocketInterrupted);
+        }
+
+        break;
+    }
+    default:
+        break;
+    }
+
+    m_timer.SetEndTime();
+    TranslateSocketError();
+
+    //--------------------------------------------------------------------------
+    // If we encounter an error translate the error code and return.  One
+    // possible error code could be EAGAIN (EWOULDBLOCK) if the socket is
+    // non-blocking.  This does not mean there is an error, but no data is
+    // yet available on the socket.
+    //--------------------------------------------------------------------------
+    if (m_nBytesReceived == CSimpleSocket::SocketError)
+    {
+        if (m_pBuffer != NULL)
+        {
+            delete [] m_pBuffer;
+            m_pBuffer = NULL;
+        }
+    }
+
+    return m_nBytesReceived;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetNonblocking()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetNonblocking(void)
+{
+    int32  nCurFlags;
+
+#if WIN32
+    nCurFlags = 1;
+
+    if (ioctlsocket(m_socket, FIONBIO, (ULONG *)&nCurFlags) != 0)
+    {
+        TranslateSocketError();
+        return false;
+    }
+#else
+    if ((nCurFlags = fcntl(m_socket, F_GETFL)) < 0)
+    {
+        TranslateSocketError();
+        return false;
+    }
+
+    nCurFlags |= O_NONBLOCK;
+
+    if (fcntl(m_socket, F_SETFL, nCurFlags) != 0)
+    {
+        TranslateSocketError();
+        return false;
+    }
+#endif
+
+    m_bIsBlocking = false;
+
+    return true;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SetBlocking()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::SetBlocking(void)
+{
+    int32 nCurFlags;
+
+#if WIN32
+    nCurFlags = 0;
+
+    if (ioctlsocket(m_socket, FIONBIO, (ULONG *)&nCurFlags) != 0)
+    {
+        return false;
+    }
+#else
+    if ((nCurFlags = fcntl(m_socket, F_GETFL)) < 0)
+    {
+        TranslateSocketError();
+        return false;
+    }
+
+    nCurFlags &= (~O_NONBLOCK);
+
+    if (fcntl(m_socket, F_SETFL, nCurFlags) != 0)
+    {
+        TranslateSocketError();
+        return false;
+    }
+#endif
+    m_bIsBlocking = true;
+
+    return true;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// SendFile() - stands-in for system provided sendfile
+//
+//------------------------------------------------------------------------------
+int32 CSimpleSocket::SendFile(int32 nOutFd, int32 nInFd, off_t *pOffset, int32 nCount)
+{
+    int32  nOutCount = CSimpleSocket::SocketError;
+
+    static char szData[SOCKET_SENDFILE_BLOCKSIZE];
+    int32       nInCount = 0;
+
+    if (lseek(nInFd, *pOffset, SEEK_SET) == -1)
+    {
+        return -1;
+    }
+
+    while (nOutCount < nCount)
+    {
+        nInCount = (nCount - nOutCount) < SOCKET_SENDFILE_BLOCKSIZE ? (nCount - nOutCount) : SOCKET_SENDFILE_BLOCKSIZE;
+
+        if ((read(nInFd, szData, nInCount)) != (int32)nInCount)
+        {
+            return -1;
+        }
+
+        if ((SEND(nOutFd, szData, nInCount, 0)) != (int32)nInCount)
+        {
+            return -1;
+        }
+
+        nOutCount += nInCount;
+    }
+
+    *pOffset += nOutCount;
+
+    TranslateSocketError();
+
+    return nOutCount;
+}
+
+
+//------------------------------------------------------------------------------
+//
+// TranslateSocketError() -
+//
+//------------------------------------------------------------------------------
+void CSimpleSocket::TranslateSocketError(void)
+{
+#if defined(_LINUX) || defined(_DARWIN)
+    switch (errno)
+    {
+    case EXIT_SUCCESS:
+        SetSocketError(CSimpleSocket::SocketSuccess);
+        break;
+    case ENOTCONN:
+        SetSocketError(CSimpleSocket::SocketNotconnected);
+        break;
+    case ENOTSOCK:
+    case EBADF:
+    case EACCES:
+    case EAFNOSUPPORT:
+    case EMFILE:
+    case ENFILE:
+    case ENOBUFS:
+    case ENOMEM:
+    case EPROTONOSUPPORT:
+    case EPIPE:
+    case EOPNOTSUPP:
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+        break;
+    case ECONNREFUSED :
+        SetSocketError(CSimpleSocket::SocketConnectionRefused);
+        break;
+    case ETIMEDOUT:
+        SetSocketError(CSimpleSocket::SocketTimedout);
+        break;
+    case EINPROGRESS:
+        SetSocketError(CSimpleSocket::SocketEinprogress);
+        break;
+    case EWOULDBLOCK:
+        //        case EAGAIN:
+        SetSocketError(CSimpleSocket::SocketEwouldblock);
+        break;
+    case EINTR:
+        SetSocketError(CSimpleSocket::SocketInterrupted);
+        break;
+    case ECONNABORTED:
+        SetSocketError(CSimpleSocket::SocketConnectionAborted);
+        break;
+    case EINVAL:
+    case EPROTO:
+        SetSocketError(CSimpleSocket::SocketProtocolError);
+        break;
+    case EPERM:
+        SetSocketError(CSimpleSocket::SocketFirewallError);
+        break;
+    case EFAULT:
+        SetSocketError(CSimpleSocket::SocketInvalidSocketBuffer);
+        break;
+    case ECONNRESET:
+    case ENOPROTOOPT:
+        SetSocketError(CSimpleSocket::SocketConnectionReset);
+        break;
+    case EADDRINUSE:
+        SetSocketError(CSimpleSocket::SocketAddressInUse);
+        break;
+    default:
+        SetSocketError(CSimpleSocket::SocketEunknown);
+        break;
+    }
+#endif
+#ifdef WIN32
+    int32 nError = WSAGetLastError();
+    switch (nError)
+    {
+    case EXIT_SUCCESS:
+        SetSocketError(CSimpleSocket::SocketSuccess);
+        break;
+    case WSAEBADF:
+    case WSAENOTCONN:
+        SetSocketError(CSimpleSocket::SocketNotconnected);
+        break;
+    case WSAEINTR:
+        SetSocketError(CSimpleSocket::SocketInterrupted);
+        break;
+    case WSAEACCES:
+    case WSAEAFNOSUPPORT:
+    case WSAEINVAL:
+    case WSAEMFILE:
+    case WSAENOBUFS:
+    case WSAEPROTONOSUPPORT:
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+        break;
+    case WSAECONNREFUSED :
+        SetSocketError(CSimpleSocket::SocketConnectionRefused);
+        break;
+    case WSAETIMEDOUT:
+        SetSocketError(CSimpleSocket::SocketTimedout);
+        break;
+    case WSAEINPROGRESS:
+        SetSocketError(CSimpleSocket::SocketEinprogress);
+        break;
+    case WSAECONNABORTED:
+        SetSocketError(CSimpleSocket::SocketConnectionAborted);
+        break;
+    case WSAEWOULDBLOCK:
+        SetSocketError(CSimpleSocket::SocketEwouldblock);
+        break;
+    case WSAENOTSOCK:
+        SetSocketError(CSimpleSocket::SocketInvalidSocket);
+        break;
+    case WSAECONNRESET:
+        SetSocketError(CSimpleSocket::SocketConnectionReset);
+        break;
+    case WSANO_DATA:
+        SetSocketError(CSimpleSocket::SocketInvalidAddress);
+        break;
+    case WSAEADDRINUSE:
+        SetSocketError(CSimpleSocket::SocketAddressInUse);
+        break;
+    case WSAEFAULT:
+        SetSocketError(CSimpleSocket::SocketInvalidPointer);
+        break;
+    default:
+        SetSocketError(CSimpleSocket::SocketEunknown);
+        break;
+    }
+#endif
+}
+
+//------------------------------------------------------------------------------
+//
+// DescribeError()
+//
+//------------------------------------------------------------------------------
+
+const char *CSimpleSocket::DescribeError(CSocketError err)
+{
+    switch (err) {
+        case CSimpleSocket::SocketError:
+            return "Generic socket error translates to error below.";
+        case CSimpleSocket::SocketSuccess:
+            return "No socket error.";
+        case CSimpleSocket::SocketInvalidSocket:
+            return "Invalid socket handle.";
+        case CSimpleSocket::SocketInvalidAddress:
+            return "Invalid destination address specified.";
+        case CSimpleSocket::SocketInvalidPort:
+            return "Invalid destination port specified.";
+        case CSimpleSocket::SocketConnectionRefused:
+            return "No server is listening at remote address.";
+        case CSimpleSocket::SocketTimedout:
+            return "Timed out while attempting operation.";
+        case CSimpleSocket::SocketEwouldblock:
+            return "Operation would block if socket were blocking.";
+        case CSimpleSocket::SocketNotconnected:
+            return "Currently not connected.";
+        case CSimpleSocket::SocketEinprogress:
+            return "Socket is non-blocking and the connection cannot be completed immediately";
+        case CSimpleSocket::SocketInterrupted:
+            return "Call was interrupted by a signal that was caught before a valid connection arrived.";
+        case CSimpleSocket::SocketConnectionAborted:
+            return "The connection has been aborted.";
+        case CSimpleSocket::SocketProtocolError:
+            return "Invalid protocol for operation.";
+        case CSimpleSocket::SocketFirewallError:
+            return "Firewall rules forbid connection.";
+        case CSimpleSocket::SocketInvalidSocketBuffer:
+            return "The receive buffer point outside the process's address space.";
+        case CSimpleSocket::SocketConnectionReset:
+            return "Connection was forcibly closed by the remote host.";
+        case CSimpleSocket::SocketAddressInUse:
+            return "Address already in use.";
+        case CSimpleSocket::SocketInvalidPointer:
+            return "Pointer type supplied as argument is invalid.";
+        case CSimpleSocket::SocketEunknown:
+            return "Unknown error";
+        default:
+            return "No such CSimpleSocket error";
+    }
+}
+
+//------------------------------------------------------------------------------
+//
+// Select()
+//
+//------------------------------------------------------------------------------
+bool CSimpleSocket::Select(int32 nTimeoutSec, int32 nTimeoutUSec)
+{
+    bool            bRetVal = false;
+    struct timeval *pTimeout = NULL;
+    struct timeval  timeout;
+    int32           nNumDescriptors = -1;
+    int32           nError = 0;
+
+    FD_ZERO(&m_errorFds);
+    FD_ZERO(&m_readFds);
+    FD_ZERO(&m_writeFds);
+    FD_SET(m_socket, &m_errorFds);
+    FD_SET(m_socket, &m_readFds);
+    FD_SET(m_socket, &m_writeFds);
+
+    //---------------------------------------------------------------------
+    // If timeout has been specified then set value, otherwise set timeout
+    // to NULL which will block until a descriptor is ready for read/write
+    // or an error has occurred.
+    //---------------------------------------------------------------------
+    if ((nTimeoutSec > 0) || (nTimeoutUSec > 0))
+    {
+        timeout.tv_sec = nTimeoutSec;
+        timeout.tv_usec = nTimeoutUSec;
+        pTimeout = &timeout;
+    }
+
+    nNumDescriptors = SELECT(m_socket+1, &m_readFds, &m_writeFds, &m_errorFds, pTimeout);
+//    nNumDescriptors = SELECT(m_socket+1, &m_readFds, NULL, NULL, pTimeout);
+
+    //----------------------------------------------------------------------
+    // Handle timeout
+    //----------------------------------------------------------------------
+    if (nNumDescriptors == 0)
+    {
+        SetSocketError(CSimpleSocket::SocketTimedout);
+    }
+    //----------------------------------------------------------------------
+    // If a file descriptor (read/write) is set then check the
+    // socket error (SO_ERROR) to see if there is a pending error.
+    //----------------------------------------------------------------------
+    else if ((FD_ISSET(m_socket, &m_readFds)) || (FD_ISSET(m_socket, &m_writeFds)))
+    {
+        int32 nLen = sizeof(nError);
+
+        if (GETSOCKOPT(m_socket, SOL_SOCKET, SO_ERROR, &nError, &nLen) == 0)
+        {
+            errno = nError;
+
+            if (nError == 0)
+            {
+                bRetVal = true;
+            }
+        }
+
+        TranslateSocketError();
+    }
+
+    return bRetVal;
+}
+

+ 584 - 0
pico-tcp-service/pico-tcp/src/SimpleSocket.h

@@ -0,0 +1,584 @@
+/*---------------------------------------------------------------------------*/
+/*                                                                           */
+/* SimpleSocket.h - Simple Socket base class decleration.                    */
+/*                                                                           */
+/* Author : Mark Carrier (mark@carrierlabs.com)                              */
+/*                                                                           */
+/*---------------------------------------------------------------------------*/
+/* Copyright (c) 2007-2009 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#ifndef __SOCKET_H__
+#define __SOCKET_H__
+
+#include <sys/stat.h>
+#include <stdlib.h>
+#include <stdio.h>
+#include <stdarg.h>
+#include <errno.h>
+
+#if defined(_LINUX) || defined (_DARWIN)
+#include <sys/socket.h>
+#include <netinet/in.h>
+#include <arpa/inet.h>
+#include <netinet/tcp.h>
+#include <netinet/ip.h>
+#include <netdb.h>
+#endif
+#ifdef _LINUX
+#include <linux/if_packet.h>
+#include <linux/if_ether.h>
+#include <linux/if.h>
+#include <sys/sendfile.h>
+#endif
+#ifdef _DARWIN
+#include <net/if.h>
+#endif
+#if defined(_LINUX) || defined (_DARWIN)
+#include <sys/time.h>
+#include <sys/uio.h>
+#include <unistd.h>
+#include <fcntl.h>
+#endif
+
+#ifdef _WIN32
+#include <io.h>
+#include <winsock2.h>
+#include <ws2tcpip.h>
+#endif // _WIN32
+
+
+#define IPTOS_LOWDELAY  0x10
+
+#include "Host.h"
+#include "StatTimer.h"
+
+//-----------------------------------------------------------------------------
+// General class macro definitions and typedefs
+//-----------------------------------------------------------------------------
+#ifndef INVALID_SOCKET
+#define INVALID_SOCKET    ~(0)
+#endif
+
+#define SOCKET_SENDFILE_BLOCKSIZE 8192
+
+/// Provides a platform independent class to for socket development.
+/// This class is designed to abstract socket communication development in a
+/// platform independent manner.
+/// - Socket types
+///  -# CActiveSocket Class
+///  -# CPassiveSocket Class
+class EXPORT CSimpleSocket {
+public:
+    /// Defines the three possible states for shuting down a socket.
+    typedef enum
+    {
+        Receives = SHUT_RD, ///< Shutdown passive socket.
+        Sends = SHUT_WR,    ///< Shutdown active socket.
+        Both = SHUT_RDWR    ///< Shutdown both active and passive sockets.
+    } CShutdownMode;
+
+    /// Defines the socket types defined by CSimpleSocket class.
+    typedef enum
+    {
+        SocketTypeInvalid,   ///< Invalid socket type.
+        SocketTypeTcp,       ///< Defines socket as TCP socket.
+        SocketTypeUdp,       ///< Defines socket as UDP socket.
+        SocketTypeTcp6,      ///< Defines socket as IPv6 TCP socket.
+        SocketTypeUdp6,      ///< Defines socket as IPv6 UDP socket.
+        SocketTypeRaw        ///< Provides raw network protocol access.
+    } CSocketType;
+
+    /// Defines all error codes handled by the CSimpleSocket class.
+    typedef enum
+    {
+        SocketError = -1,          ///< Generic socket error translates to error below.
+        SocketSuccess = 0,         ///< No socket error.
+        SocketInvalidSocket,       ///< Invalid socket handle.
+        SocketInvalidAddress,      ///< Invalid destination address specified.
+        SocketInvalidPort,         ///< Invalid destination port specified.
+        SocketConnectionRefused,   ///< No server is listening at remote address.
+        SocketTimedout,            ///< Timed out while attempting operation.
+        SocketEwouldblock,         ///< Operation would block if socket were blocking.
+        SocketNotconnected,        ///< Currently not connected.
+        SocketEinprogress,         ///< Socket is non-blocking and the connection cannot be completed immediately
+        SocketInterrupted,         ///< Call was interrupted by a signal that was caught before a valid connection arrived.
+        SocketConnectionAborted,   ///< The connection has been aborted.
+        SocketProtocolError,       ///< Invalid protocol for operation.
+        SocketFirewallError,       ///< Firewall rules forbid connection.
+        SocketInvalidSocketBuffer, ///< The receive buffer point outside the process's address space.
+        SocketConnectionReset,     ///< Connection was forcibly closed by the remote host.
+        SocketAddressInUse,        ///< Address already in use.
+        SocketInvalidPointer,      ///< Pointer type supplied as argument is invalid.
+        SocketEunknown             ///< Unknown error please report to mark@carrierlabs.com
+    } CSocketError;
+
+public:
+    CSimpleSocket(CSocketType type = SocketTypeTcp);
+    CSimpleSocket(CSimpleSocket &socket);
+
+    virtual ~CSimpleSocket()
+    {
+        if (m_pBuffer != NULL)
+        {
+            delete [] m_pBuffer;
+            m_pBuffer = NULL;
+        }
+    };
+
+    /// Initialize instance of CSocket.  This method MUST be called before an
+    /// object can be used. Errors : CSocket::SocketProtocolError,
+    /// CSocket::SocketInvalidSocket,
+    /// @return true if properly initialized.
+    virtual bool Initialize(void);
+
+    /// Close socket
+    /// @return true if successfully closed otherwise returns false.
+    virtual bool Close(void);
+
+    /// Shutdown shut down socket send and receive operations
+    ///    CShutdownMode::Receives - Disables further receive operations.
+    ///    CShutdownMode::Sends    - Disables further send operations.
+    ///    CShutdownBoth::         - Disables further send and receive operations.
+    /// @param nShutdown specifies the type of shutdown.
+    /// @return true if successfully shutdown otherwise returns false.
+    virtual bool Shutdown(CShutdownMode nShutdown);
+
+    /// Examine the socket descriptor sets currently owned by the instance of
+    /// the socket class (the readfds, writefds, and errorfds parameters) to
+    /// see whether some of their descriptors are ready for reading, are ready
+    /// for writing, or have an exceptional condition pending, respectively.
+    /// Block until an event happens on the specified file descriptors.
+    /// @return true if socket has data ready, or false if not ready or timed out.
+    virtual bool Select(void) {
+        return Select(0,0);
+    };
+
+    /// Examine the socket descriptor sets currently owned by the instance of
+    /// the socket class (the readfds, writefds, and errorfds parameters) to
+    /// see whether some of their descriptors are ready for reading, are ready
+    /// for writing, or have an exceptional condition pending, respectively.
+    /// @param nTimeoutSec timeout in seconds for select.
+    /// @param nTimeoutUSec timeout in micro seconds for select.
+    /// @return true if socket has data ready, or false if not ready or timed out.
+    virtual bool Select(int32 nTimeoutSec, int32 nTimeoutUSec);
+
+    /// Does the current instance of the socket object contain a valid socket
+    /// descriptor.
+    ///  @return true if the socket object contains a valid socket descriptor.
+    virtual bool IsSocketValid(void) {
+        return (m_socket != SocketError);
+    };
+
+    /// Provides a standard error code for cross platform development by
+    /// mapping the operating system error to an error defined by the CSocket
+    /// class.
+    void TranslateSocketError(void);
+
+    /// Returns a human-readable description of the given error code
+    /// or the last error code of a socket
+    static const char *DescribeError(CSocketError err);
+    inline const char *DescribeError() {
+        return DescribeError(m_socketErrno);
+    };
+
+    /// Attempts to receive a block of data on an established connection.
+    /// @param nMaxBytes maximum number of bytes to receive.
+    /// @param pBuffer, memory where to receive the data,
+    ///        NULL receives to internal buffer returned with GetData()
+    ///        Non-NULL receives directly there, but GetData() will return WRONG ptr!
+    /// @return number of bytes actually received.
+    /// @return of zero means the connection has been shutdown on the other side.
+    /// @return of -1 means that an error has occurred.
+    virtual int32 Receive(int32 nMaxBytes = 1, uint8 * pBuffer = 0);
+
+    /// Attempts to send a block of data on an established connection.
+    /// @param pBuf block of data to be sent.
+    /// @param bytesToSend size of data block to be sent.
+    /// @return number of bytes actually sent.
+    /// @return of zero means the connection has been shutdown on the other side.
+    /// @return of -1 means that an error has occurred.
+    virtual int32 Send(const uint8 *pBuf, size_t bytesToSend);
+
+    /// Attempts to send at most nNumItem blocks described by sendVector
+    /// to the socket descriptor associated with the socket object.
+    /// @param sendVector pointer to an array of iovec structures
+    /// @param nNumItems number of items in the vector to process
+    /// <br>\b NOTE: Buffers are processed in the order specified.
+    /// @return number of bytes actually sent, return of zero means the
+    /// connection has been shutdown on the other side, and a return of -1
+    /// means that an error has occurred.
+    virtual int32 Send(const struct iovec *sendVector, int32 nNumItems);
+
+    /// Copies data between one file descriptor and another.
+    /// On some systems this copying is done within the kernel, and thus is
+    /// more efficient than the combination of CSimpleSocket::Send and
+    /// CSimpleSocket::Receive, which would require transferring data to and
+    /// from user space.
+    /// <br>\b Note: This is available on all implementations, but the kernel
+    /// implementation is only available on Unix type systems.
+    /// @param nOutFd descriptor opened for writing.
+    /// @param nInFd descriptor opened for reading.
+    /// @param pOffset from which to start reading data from input file.
+    /// @param nCount number of bytes to copy between file descriptors.
+    /// @return number of bytes written to the out socket descriptor.
+    virtual int32 SendFile(int32 nOutFd, int32 nInFd, off_t *pOffset, int32 nCount);
+
+    /// Returns blocking/non-blocking state of socket.
+    /// @return true if the socket is non-blocking, else return false.
+    bool IsNonblocking(void) {
+        return (m_bIsBlocking == false);
+    };
+
+    /// Set the socket to blocking.
+    /// @return true if successful set to blocking, else return false;
+    bool SetBlocking(void);
+
+    /// Set the socket as non-blocking.
+    /// @return true if successful set to non-blocking, else return false;
+    bool SetNonblocking(void);
+
+    /// Get a pointer to internal receive buffer.  The user MUST not free this
+    /// pointer when finished.  This memory is managed internally by the CSocket
+    /// class.
+    /// @return pointer to data if valid, else returns NULL.
+    uint8 *GetData(void)  {
+        return m_pBuffer;
+    };
+
+    /// Returns the number of bytes received on the last call to
+    /// CSocket::Receive().
+    /// @return number of bytes received.
+    int32 GetBytesReceived(void) {
+        return m_nBytesReceived;
+    };
+
+    /// Returns the number of bytes sent on the last call to
+    /// CSocket::Send().
+    /// @return number of bytes sent.
+    int32 GetBytesSent(void) {
+        return m_nBytesSent;
+    };
+
+    /// Controls the actions taken when CSimpleSocket::Close is executed on a
+    /// socket object that has unsent data.  The default value for this option
+    /// is \b off.
+    /// - Following are the three possible scenarios.
+    ///  -# \b bEnable is false, CSimpleSocket::Close returns immediately, but
+    ///  any unset data is transmitted (after CSimpleSocket::Close returns)
+    ///  -# \b bEnable is true and \b nTime is zero, CSimpleSocket::Close return
+    /// immediately and any unsent data is discarded.
+    ///  -# \b bEnable is true and \b nTime is nonzero, CSimpleSocket::Close does
+    ///  not return until all unsent data is transmitted (or the connection is
+    ///  Closed by the remote system).
+    /// <br><p>
+    /// @param bEnable true to enable option false to disable option.
+    /// @param nTime time in seconds to linger.
+    /// @return true if option successfully set
+    bool SetOptionLinger(bool bEnable, uint16 nTime);
+
+    /// Tells the kernel that even if this port is busy (in the TIME_WAIT state),
+    /// go ahead and reuse it anyway.  If it is busy, but with another state,
+    /// you will still get an address already in use error.
+    /// @return true if option successfully set
+    bool SetOptionReuseAddr();
+
+    /// Gets the timeout value that specifies the maximum number of seconds a
+    /// call to CSimpleSocket::Open waits until it completes.
+    /// @return the length of time in seconds
+    int32 GetConnectTimeoutSec(void) {
+        return  m_stConnectTimeout.tv_sec;
+    };
+
+    /// Gets the timeout value that specifies the maximum number of microseconds
+    /// a call to CSimpleSocket::Open waits until it completes.
+    /// @return the length of time in microseconds
+    int32 GetConnectTimeoutUSec(void) {
+        return  m_stConnectTimeout.tv_usec;
+    };
+
+    /// Sets the timeout value that specifies the maximum amount of time a call
+    /// to CSimpleSocket::Receive waits until it completes. Use the method
+    /// CSimpleSocket::SetReceiveTimeout to specify the number of seconds to wait.
+    /// If a call to CSimpleSocket::Receive has blocked for the specified length of
+    /// time without receiving additional data, it returns with a partial count
+    /// or CSimpleSocket::GetSocketError set to CSimpleSocket::SocketEwouldblock if no data
+    /// were received.
+    /// @param nConnectTimeoutSec of timeout in seconds.
+    /// @param nConnectTimeoutUsec of timeout in microseconds.
+    /// @return true if socket connection timeout was successfully set.
+    void SetConnectTimeout(int32 nConnectTimeoutSec, int32 nConnectTimeoutUsec = 0)
+    {
+        m_stConnectTimeout.tv_sec = nConnectTimeoutSec;
+        m_stConnectTimeout.tv_usec = nConnectTimeoutUsec;
+    };
+
+    /// Gets the timeout value that specifies the maximum number of seconds a
+    /// a call to CSimpleSocket::Receive waits until it completes.
+    /// @return the length of time in seconds
+    int32 GetReceiveTimeoutSec(void) {
+        return  m_stRecvTimeout.tv_sec;
+    };
+
+    /// Gets the timeout value that specifies the maximum number of microseconds
+    /// a call to CSimpleSocket::Receive waits until it completes.
+    /// @return the length of time in microseconds
+    int32 GetReceiveTimeoutUSec(void) {
+        return  m_stRecvTimeout.tv_usec;
+    };
+
+    /// Sets the timeout value that specifies the maximum amount of time a call
+    /// to CSimpleSocket::Receive waits until it completes. Use the method
+    /// CSimpleSocket::SetReceiveTimeout to specify the number of seconds to wait.
+    /// If a call to CSimpleSocket::Receive has blocked for the specified length of
+    /// time without receiving additional data, it returns with a partial count
+    /// or CSimpleSocket::GetSocketError set to CSimpleSocket::SocketEwouldblock if no data
+    /// were received.
+    ///  @param nRecvTimeoutSec of timeout in seconds.
+    ///  @param nRecvTimeoutUsec of timeout in microseconds.
+    ///  @return true if socket timeout was successfully set.
+    bool SetReceiveTimeout(int32 nRecvTimeoutSec, int32 nRecvTimeoutUsec = 0);
+
+    /// Enable/disable multicast for a socket.  This options is only valid for
+    /// socket descriptors of type CSimpleSocket::SocketTypeUdp.
+    /// @return true if multicast was enabled or false if socket type is not
+    /// CSimpleSocket::SocketTypeUdp and the error will be set to
+    /// CSimpleSocket::SocketProtocolError
+    bool SetMulticast(bool bEnable, uint8 multicastTTL = 1);
+
+    /// Return true if socket is multicast or false is socket is unicast
+    /// @return true if multicast is enabled
+    bool GetMulticast() {
+        return m_bIsMulticast;
+    };
+
+    /// Bind socket to a specific interface when using multicast.
+    /// @return true if successfully bound to interface
+    bool BindInterface(const char *pInterface);
+
+    /// Gets the timeout value that specifies the maximum number of seconds a
+    /// a call to CSimpleSocket::Send waits until it completes.
+    /// @return the length of time in seconds
+    int32 GetSendTimeoutSec(void) {
+        return  m_stSendTimeout.tv_sec;
+    };
+
+    /// Gets the timeout value that specifies the maximum number of microseconds
+    /// a call to CSimpleSocket::Send waits until it completes.
+    /// @return the length of time in microseconds
+    int32 GetSendTimeoutUSec(void) {
+        return  m_stSendTimeout.tv_usec;
+    };
+
+    /// Gets the timeout value that specifies the maximum amount of time a call
+    /// to CSimpleSocket::Send waits until it completes.
+    /// @return the length of time in seconds
+    bool SetSendTimeout(int32 nSendTimeoutSec, int32 nSendTimeoutUsec = 0);
+
+    /// Returns the last error that occured for the instace of the CSimpleSocket
+    /// instance.  This method should be called immediately to retrieve the
+    /// error code for the failing mehtod call.
+    ///  @return last error that occured.
+    CSocketError GetSocketError(void) {
+        return m_socketErrno;
+    };
+
+    /// Get the total time the of the last operation in milliseconds.
+    ///  @return number of milliseconds of last operation.
+    uint32 GetTotalTimeMs() {
+        return m_timer.GetMilliSeconds();
+    };
+
+    /// Get the total time the of the last operation in microseconds.
+    ///  @return number of microseconds or last operation.
+    uint32 GetTotalTimeUsec() {
+        return m_timer.GetMicroSeconds();
+    };
+
+    /// Return Differentiated Services Code Point (DSCP) value currently set on the socket object.
+    /// @return DSCP for current socket object.
+    /// <br><br> \b NOTE: Windows special notes http://support.microsoft.com/kb/248611.
+    int GetSocketDscp(void);
+
+    /// Set Differentiated Services Code Point (DSCP) for socket object.
+    ///  @param nDscp value of TOS setting which will be converted to DSCP
+    ///  @return true if DSCP value was properly set
+    /// <br><br> \b NOTE: Windows special notes http://support.microsoft.com/kb/248611.
+    bool SetSocketDscp(int nDscp);
+
+    /// Return socket descriptor
+    ///  @return socket descriptor which is a signed 32 bit integer.
+    SOCKET GetSocketDescriptor() {
+        return m_socket;
+    };
+
+    /// Return socket descriptor
+    ///  @return socket descriptor which is a signed 32 bit integer.
+    CSocketType GetSocketType() {
+        return m_nSocketType;
+    };
+
+    /// Returns clients Internet host address as a string in standard numbers-and-dots notation.
+    ///  @return NULL if invalid
+    const char *GetClientAddr() {
+        return inet_ntoa(m_stClientSockaddr.sin_addr);
+    };
+
+    /// Returns the port number on which the client is connected.
+    ///  @return client port number.
+    uint16 GetClientPort() {
+        return m_stClientSockaddr.sin_port;
+    };
+
+    /// Returns server Internet host address as a string in standard numbers-and-dots notation.
+    ///  @return NULL if invalid
+    const char *GetServerAddr() {
+        return inet_ntoa(m_stServerSockaddr.sin_addr);
+    };
+
+    /// Returns the port number on which the server is connected.
+    ///  @return server port number.
+    uint16 GetServerPort() {
+        return ntohs(m_stServerSockaddr.sin_port);
+    };
+
+    /// Get the TCP receive buffer window size for the current socket object.
+    /// <br><br>\b NOTE: Linux will set the receive buffer to twice the value passed.
+    ///  @return zero on failure else the number of bytes of the TCP receive buffer window size if successful.
+    uint32 GetReceiveWindowSize() {
+        return GetWindowSize(SO_RCVBUF);
+    };
+
+    /// Get the TCP send buffer window size for the current socket object.
+    /// <br><br>\b NOTE: Linux will set the send buffer to twice the value passed.
+    ///  @return zero on failure else the number of bytes of the TCP receive buffer window size if successful.
+    uint32 GetSendWindowSize() {
+        return GetWindowSize(SO_SNDBUF);
+    };
+
+    /// Set the TCP receive buffer window size for the current socket object.
+    /// <br><br>\b NOTE: Linux will set the receive buffer to twice the value passed.
+    ///  @return zero on failure else the number of bytes of the TCP send buffer window size if successful.
+    uint32 SetReceiveWindowSize(uint32 nWindowSize) {
+        return SetWindowSize(SO_RCVBUF, nWindowSize);
+    };
+
+    /// Set the TCP send buffer window size for the current socket object.
+    /// <br><br>\b NOTE: Linux will set the send buffer to twice the value passed.
+    ///  @return zero on failure else the number of bytes of the TCP send buffer window size if successful.
+    uint32 SetSendWindowSize(uint32 nWindowSize) {
+        return SetWindowSize(SO_SNDBUF, nWindowSize);
+    };
+
+    /// Disable the Nagle algorithm (Set TCP_NODELAY to true)
+    /// @return false if failed to set socket option otherwise return true;
+    bool DisableNagleAlgoritm();
+
+    /// Enable the Nagle algorithm (Set TCP_NODELAY to false)
+    /// @return false if failed to set socket option otherwise return true;
+    bool EnableNagleAlgoritm();
+
+
+protected:
+    /// Set internal socket error to that specified error
+    ///  @param error type of error
+    void SetSocketError(CSimpleSocket::CSocketError error) {
+        m_socketErrno = error;
+    };
+
+    /// Set object socket handle to that specified as parameter
+    ///  @param socket value of socket descriptor
+    void SetSocketHandle(SOCKET socket) {
+        m_socket = socket;
+    };
+
+private:
+    /// Generic function used to get the send/receive window size
+    ///  @return zero on failure else the number of bytes of the TCP window size if successful.
+    uint32 GetWindowSize(uint32 nOptionName);
+
+    /// Generic function used to set the send/receive window size
+    ///  @return zero on failure else the number of bytes of the TCP window size if successful.
+    uint32 SetWindowSize(uint32 nOptionName, uint32 nWindowSize);
+
+
+    /// Attempts to send at most nNumItem blocks described by sendVector
+    /// to the socket descriptor associated with the socket object.
+    /// @param sendVector pointer to an array of iovec structures
+    /// @param nNumItems number of items in the vector to process
+    /// <br>\b Note: This implementation is for systems that don't natively
+    /// support this functionality.
+    /// @return number of bytes actually sent, return of zero means the
+    /// connection has been shutdown on the other side, and a return of -1
+    /// means that an error has occurred.
+    int32 Writev(const struct iovec *pVector, size_t nCount);
+
+    /// Flush the socket descriptor owned by the object.
+    /// @return true data was successfully sent, else return false;
+    bool Flush();
+
+    CSimpleSocket *operator=(CSimpleSocket &socket);
+
+protected:
+    SOCKET               m_socket;            /// socket handle
+    CSocketError         m_socketErrno;       /// number of last error
+    uint8               *m_pBuffer;           /// internal send/receive buffer
+    int32                m_nBufferSize;       /// size of internal send/receive buffer
+    int32                m_nSocketDomain;     /// socket type PF_INET, PF_INET6
+    CSocketType          m_nSocketType;       /// socket type - UDP, TCP or RAW
+    int32                m_nBytesReceived;    /// number of bytes received
+    int32                m_nBytesSent;        /// number of bytes sent
+    uint32               m_nFlags;            /// socket flags
+    bool                 m_bIsBlocking;       /// is socket blocking
+    bool                 m_bIsMulticast;      /// is the UDP socket multicast;
+    struct timeval       m_stConnectTimeout;  /// connection timeout
+    struct timeval       m_stRecvTimeout;     /// receive timeout
+    struct timeval       m_stSendTimeout;     /// send timeout
+    struct sockaddr_in   m_stServerSockaddr;  /// server address
+    struct sockaddr_in   m_stClientSockaddr;  /// client address
+    struct sockaddr_in   m_stMulticastGroup;  /// multicast group to bind to
+    struct linger        m_stLinger;          /// linger flag
+    CStatTimer           m_timer;             /// internal statistics.
+#ifdef WIN32
+    WSADATA              m_hWSAData;          /// Windows
+#endif
+    fd_set               m_writeFds;          /// write file descriptor set
+    fd_set               m_readFds;           /// read file descriptor set
+    fd_set               m_errorFds;          /// error file descriptor set
+};
+
+
+#endif /*  __SOCKET_H__  */
+

+ 114 - 0
pico-tcp-service/pico-tcp/src/StatTimer.h

@@ -0,0 +1,114 @@
+/*----------------------------------------------------------------------------*/
+/*                                                                            */
+/* StatTimer.h: interface for the CStatTimer class.                           */
+/*                                                                            */
+/* Author: Mark Carrier (mark@carrierlabs.com)                                */
+/*                                                                            */
+/*----------------------------------------------------------------------------*/
+/* Copyright (c) 2006 CarrierLabs, LLC.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ *
+ * 3. The name of the author may not be used to endorse or promote products
+ *    derived from this software without specific prior written permission.
+ *
+ * 4. The name "CarrierLabs" must not be used to
+ *    endorse or promote products derived from this software without
+ *    prior written permission. For written permission, please contact
+ *    mark@carrierlabs.com.
+ *
+ * THIS SOFTWARE IS PROVIDED BY MARK CARRIER ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL MARK CARRIER OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ *----------------------------------------------------------------------------*/
+#ifndef __CSTATTIMER_H__
+#define __CSTATTIMER_H__
+
+#include <string.h>
+
+#if WIN32
+  #include <Winsock2.h>
+  #include <time.h>
+#endif
+
+#ifdef _LINUX
+  #include <stdio.h>
+  #include <sys/time.h>
+#endif
+
+#include "Host.h"
+
+#if defined(WIN32)
+  #define GET_CLOCK_COUNT(x) QueryPerformanceCounter((LARGE_INTEGER *)x)
+#else
+  #define GET_CLOCK_COUNT(x) gettimeofday(x, NULL)
+#endif
+
+#define MILLISECONDS_CONVERSION 1000
+#define MICROSECONDS_CONVERSION 1000000
+
+/// Class to abstract socket communications in a cross platform manner.
+/// This class is designed
+class EXPORT CStatTimer {
+public:
+    CStatTimer()
+    {
+    };
+
+    ~CStatTimer()
+    {
+    };
+
+    void Initialize()
+    {
+        memset(&m_startTime, 0, sizeof(struct timeval));
+        memset(&m_endTime, 0, sizeof(struct timeval));
+    };
+
+    struct timeval GetStartTime() { return m_startTime; };
+    void SetStartTime() { GET_CLOCK_COUNT(&m_startTime); };
+
+    struct timeval GetEndTime() { return m_endTime; };
+    void SetEndTime() { GET_CLOCK_COUNT(&m_endTime); };
+
+    uint32 GetMilliSeconds() { return (CalcTotalUSec() / MILLISECONDS_CONVERSION); };
+    uint32 GetMicroSeconds() { return (CalcTotalUSec()); };
+    uint32 GetSeconds() { return (CalcTotalUSec() / MICROSECONDS_CONVERSION); };
+
+    uint32 GetCurrentTime()
+    {
+        struct timeval tmpTime;
+        GET_CLOCK_COUNT(&tmpTime);
+        return ((tmpTime.tv_sec * MICROSECONDS_CONVERSION) + tmpTime.tv_usec);
+    };
+
+private:
+    uint32 CalcTotalUSec() { return (((m_endTime.tv_sec - m_startTime.tv_sec) * MICROSECONDS_CONVERSION) +
+                                    (m_endTime.tv_usec - m_startTime.tv_usec)); };
+
+
+private:
+    struct timeval  m_startTime;
+    struct timeval  m_endTime;
+};
+
+#endif // __CSTATTIMER_H__

+ 466 - 0
pico-tcp-service/pico-tcp/src/requests.cpp

@@ -0,0 +1,466 @@
+#pragma once
+#include <iostream>
+#include <fstream>
+#include <vector>
+#include <malloc.h>
+#include <algorithm>
+#include <thread>
+#include <chrono>
+#include <sstream>
+#include <string>
+#include <iomanip>
+#include <cstdint>
+#include <bitset>
+#include "simplelogger.hpp"
+using namespace std;
+
+extern std::ostream out(std::cout.rdbuf());
+stringstream mystream;
+extern SimpleLogger newlogger = SimpleLogger(out, "sync");
+SimpleLogger errorlogger = SimpleLogger(cerr);
+SimpleLogger stringlogger = SimpleLogger(mystream);
+
+namespace request
+{
+constexpr size_t MAX_PACKET{4096};
+const int32_t NODES_PER_PACKET{200};          // Number of points for 1 package
+const uint32_t PACKETS_WO_CONFIRM{1};        // How many packages could be sent without confirmation
+const double CONFIRM_TIMEOUT_SEC{0.1};
+string hex_converting(int32_t num)
+{
+    stringlogger << hex << num;
+    if(num < 0)
+    {
+        return mystream.str().substr(4);
+    }
+    else
+    {
+        return mystream.str();
+    }
+}
+
+void ShowError(CSimpleSocket ss, string s)
+{
+
+    newlogger << " " << s << " : " << " = " << ss.DescribeError() << '\n';
+    newlogger << " IsSocketValid() = " << ss.IsSocketValid() << '\n\n';
+} //ShowError
+
+
+void get_API_version (CActiveSocket& SocketActive){ //This function send API version request and shows response
+    uint8 buf[MAX_PACKET] ;
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x0C);
+    buf[3] = uint8(0x00);
+
+    newlogger << "GET API VERSION";
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, 4) << '\n';
+    ShowError(SocketActive, "SocketActive.Send");
+
+
+    newlogger << "listening..." << '\n\n';
+    newlogger << "SocketActive.Receive = " << hex <<SocketActive.Receive(MAX_PACKET, buf) << '\n';
+    ShowError(SocketActive, "SocketActive.Receive");
+
+/// @return number of bytes actually received.
+/// @return of zero means the connection has been shutdown on the other side.
+/// @return of -1 means that an error has occurred.
+
+    newlogger << "Bytes Received : " ;
+    for(int32_t i=0; i<SocketActive.GetBytesReceived(); i++)
+        {
+            //cout << " buf[" << ii << "] = " << buf[ii] << " " << endl;
+            newlogger << hex << buf[i];
+        } //for
+        newlogger << '\n\n';
+}// get_API_version
+
+
+
+void get_sw_revision(CActiveSocket& SocketActive){ //This function send revision version request and shows response
+    uint8 buf[MAX_PACKET] ;
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x0D);
+    buf[3] = uint8(0x00);
+
+    newlogger << "GET SW REVISION";
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, 4) << '\n';
+    ShowError(SocketActive, "SocketActive.Send");
+
+
+    newlogger << "listening..." << '\n\n';
+    newlogger << "SocketActive.Receive = " << hex <<SocketActive.Receive(MAX_PACKET, buf) << '\n';
+    ShowError(SocketActive, "SocketActive.Receive");
+
+/// @return number of bytes actually received.
+/// @return of zero means the connection has been shutdown on the other side.
+/// @return of -1 means that an error has occurred.
+
+    newlogger << "Bytes Received : " ;
+    for(int32_t ii=0; ii<SocketActive.GetBytesReceived(); ii++)
+        {
+            //cout << " buf[" << ii << "] = " << buf[ii] << " " << endl;
+            newlogger << hex << buf[ii];
+        } //for
+        newlogger << '\n\n';
+}//get_sw_revision
+
+void get_gru_state(CActiveSocket& SocketActive){ //This function send request of state gradient amplifier and shows response
+    uint8 buf[MAX_PACKET] ;
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x05);
+    buf[3] = uint8(0x00);
+
+    newlogger << "GET GRU STATE";
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, 4) << '\n';
+    ShowError(SocketActive, "SocketActive.Send");
+
+
+    newlogger << "listening..." << '\n\n';
+    newlogger << "SocketActive.Receive = " << hex <<SocketActive.Receive(MAX_PACKET, buf) << '\n';
+    ShowError(SocketActive, "SocketActive.Receive");
+
+/// @return number of bytes actually received.
+/// @return of zero means the connection has been shutdown on the other side.
+/// @return of -1 means that an error has occurred.
+
+    newlogger << "Bytes Received : " ;
+    for(int32_t ii=0; ii<SocketActive.GetBytesReceived(); ii++)
+        {
+            //cout << " buf[" << ii << "] = " << buf[ii] << " " << '\n';
+            newlogger << hex << buf[ii];
+        } //for
+        newlogger << '\n\n';
+
+}//get_gru_state
+
+
+
+void socket_close(CActiveSocket SocketActive){ // This function closes socket
+newlogger << "SocketActive.Close() = " << SocketActive.Close() << '\n';
+    ShowError(SocketActive, "SocketActive.Close");
+    newlogger << "closed" << '\n';
+}
+
+vector<vector<int32_t>> get_nodes(const string& Traject_file_name) {
+    vector<vector<int32_t>> nodes;
+     ifstream myfile(Traject_file_name);
+    if (!myfile.is_open()) { // ��������, ������� �� ������ ����
+        errorlogger << "Unable to open file\n"; // ����� �� ��������� � �������
+    }
+    int32_t num1, num2;
+    while(myfile >> num1 >> num2) {
+        nodes.push_back({num1, num2});
+    }
+
+    return nodes;
+}//get nodes
+
+vector <int32_t> get_unloaded_num(vector<int32_t> segment_status){
+    vector <int32_t> res;
+    for (uint32_t i = 0; i< segment_status.size();i++){
+        if (segment_status[i] != 0){
+            res.push_back(i);
+        }
+    }
+    return res;
+
+}//get_unloaded_num
+
+//function to upload a segment of traject
+void upload_segment(CActiveSocket &SocketActive, int32_t seg_num, bool need_confirm, vector<vector<int32_t>> nodes)
+{
+    int32_t counter=0;
+    uint8 buf[MAX_PACKET]{0};
+    string str1 = hex_converting(seg_num);
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x07);
+    buf[3] = uint8(0x00);
+    counter+=4;
+
+    //data of segment traject
+    need_confirm = true;
+if(need_confirm)
+    {
+
+    buf[4] = uint8(stoi(str1, nullptr, 16));
+    buf[5] = uint8(0x80);
+    counter+=2;
+
+    }
+    else{
+        buf[4] = uint8(stoi(str1, nullptr, 16));
+        counter++;
+    }
+
+
+    int32_t NULL32=0;
+    int32_t NODES_SIZE = nodes.size();
+    int32_t first_node_idx = max( seg_num * NODES_PER_PACKET - seg_num, NULL32 );
+    int32_t last_node_idx = min( first_node_idx + NODES_PER_PACKET, NODES_SIZE) - 1;
+    int32_t nodes_in_this_packet = last_node_idx - first_node_idx + 1;
+
+    string str2 = hex_converting(nodes_in_this_packet);
+    buf[counter++] = uint8(stoi(str2, nullptr, 16));
+    buf[counter++] = uint8(0x00);
+
+    for(int i = first_node_idx; i <last_node_idx+1; i++)
+    {
+
+        string hexString1 = hex_converting(nodes[i][0]);
+        uint32_t tempcounter = counter;
+        string temp1, temp2;
+
+        for(int j = hexString1.length()-1; j > 0; j=j- 2)
+        {
+            buf[tempcounter++] = uint8(stoi(hexString1.substr(j-1,2), nullptr, 16) );
+        }
+        if(hexString1.length() % 2 != 0)
+        {
+            temp1 = hexString1[0];
+            hexString1.erase(0);
+            buf[tempcounter++] = uint8(stoi(temp1, nullptr, 16) );
+        }
+
+        counter+=4;
+
+        uint32_t tempcounter2 = counter;
+
+        string hexString2 = hex_converting(nodes[i][1]);
+
+        for(int j = hexString2.length()-1; j > 0; j -= 2)
+        {
+            buf[tempcounter2++] = uint8(stoi(hexString2.substr(j-1,2), nullptr, 16) );
+        }
+        if(hexString2.length() % 2 != 0)
+        {
+            temp2 = hexString2[0];
+            hexString1.erase(0);
+            buf[tempcounter2++] = uint8(stoi(temp2, nullptr, 16) );
+        }
+
+        counter+=2;
+    }
+
+
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, counter) << '\n';
+    ShowError(SocketActive, "SocketActive.Send");
+
+}
+
+void switch_func (string hexString, int32_t& counter, uint8 (&buf)[MAX_PACKET]){
+
+    switch(hexString.length())
+{
+    case 1:
+        {
+        buf[counter+1] = uint8(stoi(hexString, nullptr, 16));
+        break;
+        }
+
+    case 2:
+        {
+        buf[counter+1] = uint8(stoi(hexString, nullptr, 16));
+        break;
+        }
+    case 3:
+        {
+        string part1 = hexString.substr(0,1);
+        string part2 = hexString.substr(1);
+        buf[counter] = uint8(stoi(part2, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part1, nullptr, 16));
+        break;
+        }
+    case 4:
+        {
+        string part11 = hexString.substr(0,2);
+        string part22 = hexString.substr(2);
+        buf[counter] = uint8(stoi(part22, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part11, nullptr, 16));
+        break;
+        }
+
+    case 5:
+        {
+        string part11 = hexString.substr(0,2);
+        string part22 = hexString.substr(2,2);
+        string part31 = hexString.substr(4,1);
+        buf[counter] = uint8(stoi(part31, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part22, nullptr, 16));
+        buf[counter+2] = uint8(stoi(part11, nullptr, 16));
+        break;
+        }
+    case 6:
+        {
+        string part11 = hexString.substr(0,2);
+        string part22 = hexString.substr(2,2);
+        string part31 = hexString.substr(4,2);
+        buf[counter] = uint8(stoi(part31, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part22, nullptr, 16));
+        buf[counter+2] = uint8(stoi(part11, nullptr, 16));
+        break;
+        }
+    case 7:
+        {
+        string part11 = hexString.substr(0,2);
+        string part22 = hexString.substr(2,2);
+        string part31 = hexString.substr(4,2);
+        string part32 = hexString.substr(6,1);
+        buf[counter] = uint8(stoi(part32, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part31, nullptr, 16));
+        buf[counter+2] = uint8(stoi(part22, nullptr, 16));
+        buf[counter+3] = uint8(stoi(part11, nullptr, 16));
+        break;
+        }
+    case 8:
+        {
+        string part11 = hexString.substr(0,2);
+        string part22 = hexString.substr(2,2);
+        string part31 = hexString.substr(4,2);
+        string part32 = hexString.substr(6,2);
+        buf[counter] = uint8(stoi(part32, nullptr, 16));
+        buf[counter+1] = uint8(stoi(part31, nullptr, 16));
+        buf[counter+2] = uint8(stoi(part22, nullptr, 16));
+        buf[counter+3] = uint8(stoi(part11, nullptr, 16));
+        break;
+        }
+}
+
+}
+
+void upload_traj(CActiveSocket& SocketActive, vector<vector<int32_t>> nodes){
+    //This function send trajectory to gradient amplifier
+    int32_t counter = 0;
+    uint8 buf[MAX_PACKET]{0} ;
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x06);
+    buf[3] = uint8(0x00);
+    counter+=4;
+
+    string hexString = hex_converting(nodes.size());
+    string hexString2 = hex_converting(nodes[nodes.size()-1][0]);
+
+    switch_func(hexString2, counter, buf);
+    counter+=4;
+    switch_func(hexString, counter, buf);
+    counter+=4;
+
+    newlogger << "UPLOADING TRAJECTORY";
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, 12) << '\n';
+    ShowError(SocketActive, "SocketActive.Send");
+
+    int32_t nodes_cnt = nodes.size();
+    int32_t segments_cnt = nodes_cnt / NODES_PER_PACKET; // segments_count
+
+    if (nodes_cnt % NODES_PER_PACKET != 0)
+        segments_cnt += 1;
+
+    vector<int32_t> segment_status(segments_cnt); //���������� �� ���������
+    segment_status.assign(segments_cnt, -2);
+    int32_t left_wo_confirm{PACKETS_WO_CONFIRM};
+
+    //bool confirm_timeout_detected = false;
+    //string prev_debug_info = " ";
+
+    vector <int32_t> uploaded_nums;
+    uploaded_nums = get_unloaded_num(segment_status);
+    int32_t counter_uploaded_nums = uploaded_nums.size()-1;
+
+    while (!uploaded_nums.empty()){
+
+        int32_t seg_num;
+        seg_num = uploaded_nums.back();
+        uploaded_nums.pop_back();
+
+        if (segment_status[seg_num] != -2){
+            newlogger << "Repeating upload segment" << seg_num << "with status" <<segment_status[seg_num] << '\n\n';
+        }//if
+
+        //����������� �� ������������� ������?
+
+        bool need_confirm = false;    //by default
+
+        if (left_wo_confirm == 0)
+            {
+            left_wo_confirm = PACKETS_WO_CONFIRM;
+            need_confirm = true;
+            }
+        else left_wo_confirm -= 1;    //for next iteration
+
+        if (seg_num == counter_uploaded_nums)
+            need_confirm = true;
+
+        upload_segment(SocketActive, seg_num, need_confirm, nodes);
+
+        this_thread::sleep_for(chrono::microseconds(10));
+    }//while
+
+
+}//upload_traj
+
+void download_traject (CActiveSocket &SocketActive, int32_t points_cnt)
+{
+    int32_t counter=0;
+    vector<int32_t> points;
+    uint8 buf[MAX_PACKET]{0} ;
+    buf[0] = uint8(0xAA);
+    buf[1] = uint8(0xAA);
+    buf[2] = uint8(0x09);
+    buf[3] = uint8(0x00);
+    buf[4] = uint8(0x00);
+    buf[5] = uint8(0x00);
+    buf[6] = uint8(0x00);
+    buf[7] = uint8(0x00);
+    counter+=8;
+    newlogger << hex << '\t' << points_cnt << '\n';
+    switch_func(hex_converting(points_cnt), counter, buf);
+    newlogger << "DOWNLOADING TRAJECTORY";
+    newlogger << "SocketActive.Send = " << SocketActive.Send(buf, 12) << '\n\n';
+    ShowError(SocketActive, "SocketActive.Send");
+    uint32_t expected_packets_cnt = points_cnt / NODES_PER_PACKET;
+    if (points_cnt % NODES_PER_PACKET != 0)
+    {
+        expected_packets_cnt += 1;
+    }
+    vector<int32_t> downloaded_segments;
+    downloaded_segments.assign(expected_packets_cnt, 0);
+    points.assign(points_cnt, 0);
+    newlogger << "listening..." << '';
+    newlogger << "SocketActive.Receive = " << hex <<SocketActive.Receive(MAX_PACKET, buf) << '\n';
+    ShowError(SocketActive, "SocketActive.Receive");
+
+/// @return number of bytes actually received.
+/// @return of zero means the connection has been shutdown on the other side.
+/// @return of -1 means that an error has occurred.
+
+    newlogger << "Bytes Received : " ;
+    for(int32_t ii=0; ii<SocketActive.GetBytesReceived(); ii++)
+        {
+            //cout << " buf[" << ii << "] = " << buf[ii] << " " << endl;
+            newlogger << hex << buf[ii];
+        } //for
+        newlogger << '\n\n';
+
+    ofstream outFile("data.txt");
+    SimpleLogger filelogger = SimpleLogger(outFile);
+    if(!outFile.is_open())
+    {
+        errorlogger << "Error open file" << '\n';
+    }
+    for(int32_t ii=0; ii<SocketActive.GetBytesReceived(); ii++)
+        {
+            filelogger << buf[ii] << '\n';
+        } //for
+        outFile.close();
+}
+
+
+
+}
+
+

+ 23 - 0
pico-tcp-service/pico-tcp/src/requests.h

@@ -0,0 +1,23 @@
+#include "PassiveSocket.h"
+#include "requests.cpp"
+void ShowError(CSimpleSocket ss, string s);
+
+void get_API_version (CActiveSocket& SocketActive);
+
+void get_sw_revision(CActiveSocket& SocketActive);
+
+void get_gru_state(CActiveSocket& SocketActive);
+
+void socket_close(CActiveSocket SocketActive);
+
+vector <int32_t> get_unloaded_num(vector<int32_t> segment_status);
+
+void upload_segment(CActiveSocket &SocketActive, int32_t seg_num, bool need_confirm, vector<vector<int32_t>> nodes);
+
+void upload_traj(CActiveSocket& SocketActive, vector<vector<int32_t>> nodes);
+
+vector <int32_t> download_traject (CActiveSocket &SocketActive, int32_t points_cnt);
+
+vector<vector<int32_t>> get_nodes(const string& Traject_file_name);
+
+string hex_converting(int num);

+ 335 - 0
pico-tcp-service/pico-tcp/src/simplelogger.cpp

@@ -0,0 +1,335 @@
+#include "simplelogger.hpp"
+
+// Generates file name
+
+std::ostream& LogManip::setfill(std::ostream out, char c)
+{
+    out << std::setfill(c);
+    return out;
+}
+
+std::string SimpleLogger::generateFileName()
+{
+    std::chrono::time_point<std::chrono::system_clock> time_now = std::chrono::system_clock::now();
+    std::time_t t_n = std::chrono::system_clock::to_time_t(time_now);
+
+    char logfile_creation_time[100];
+    std::strftime(logfile_creation_time, sizeof(logfile_creation_time), "%Y%m%d-%H%M%S", std::localtime(&t_n));
+    std::string logname = this->log_name_prefix + "-log-" + std::string(logfile_creation_time, 100) + ".txt";
+
+    return logname;
+}
+
+// Generates prefix (in format of [TIME] / [FLAG]) for log string
+
+std::string SimpleLogger::generateLogString(int flag = INFO)
+{
+    auto time = std::chrono::system_clock::now(); // get the current time
+    std::time_t t = std::chrono::system_clock::to_time_t(time);
+
+    char log_time[100];
+    std::strftime(log_time, sizeof(log_time), "%Y-%m-%d %H:%M:%S", std::localtime(&t));
+
+    auto since_epoch = time.time_since_epoch(); // get the duration since epoch
+
+    auto time_millis = std::chrono::duration_cast<std::chrono::milliseconds>(since_epoch);
+    auto time_seconds = std::chrono::duration_cast<std::chrono::seconds>(since_epoch);
+
+    unsigned long long millis = time_millis.count() - 1000*time_seconds.count();
+
+    std::string logstring = std::string("[") + std::string(log_time) + std::string(":") + std::to_string(millis) + std::string("]");
+
+    switch(flag)
+    {
+    case ERROR:
+        logstring = logstring + " / [ERROR]\t";
+        break;
+    case WARN:
+        logstring = logstring + " / [WARN]\t";
+        break;
+    case INFO:
+        logstring = logstring + " / [INFO]\t";
+        break;
+    default:
+        logstring = logstring + " / [UNDEF]";
+        break;
+    }
+
+    return logstring;
+}
+
+// Main Constructors (we need to send reference to our main log stream)
+
+SimpleLogger::SimpleLogger(std::ostream& ls = std::cout, std::string prefix = "", std::string filename = "") : log_stream(ls)
+{
+    this->initializeLogger(filename, prefix);
+}
+
+SimpleLogger::SimpleLogger(std::ostream& ls = std::cout) : log_stream(ls)
+{
+    this->initializeLogger("", "some");
+}
+
+SimpleLogger::SimpleLogger(std::ostream& ls, std::string prefix) : log_stream(ls)
+{
+    this->initializeLogger("", prefix);
+}
+
+
+void SimpleLogger::initializeLogger(std::string filename = "", std::string prefix = "")
+{
+    this->log_flag.flag = INFO;
+    this->log_name_prefix = prefix;
+    this->log_string = "";
+    this->console_enabled = false;
+
+    if(filename == "")
+    {
+        this->log_name = generateFileName();
+    }
+    else
+    {
+        this->log_name = prefix + filename;
+    }
+
+    this->file_stream.open(this->log_name);
+    this->log_stream.rdbuf(this->file_stream.rdbuf());
+}
+
+SimpleLogger::SimpleLogger(const SimpleLogger& other) : log_stream(other.log_stream)
+{
+    this->log_flag = other.log_flag;
+    this->log_name_prefix = other.log_name_prefix;
+    this->log_string = other.log_string;
+    this->console_enabled = other.console_enabled;
+    this->log_name = other.log_name;
+}
+
+void SimpleLogger::closeLogger()
+{
+    this->file_stream.close();
+}
+
+SimpleLogger::~SimpleLogger()
+{
+    this->closeLogger();
+}
+
+void SimpleLogger::setLoggerFlag(LogPref::Flag log_flag = LogPref::Flag(INFO))
+{
+    this->log_flag = log_flag;
+}
+
+void SimpleLogger::enableConsoleOutput(bool enable_console)
+{
+    console_enabled = enable_console;
+}
+
+SimpleLogger SimpleLogger::operator<<(LogPref::Flag flag)
+{
+    SimpleLogger s(*this);
+    s.setLoggerFlag(flag);
+    return s;
+}
+
+SimpleLogger SimpleLogger::operator<<(bool val){
+    if(console_enabled){
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned long long val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(double val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(long double val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const void* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::nullptr_t) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << "nullptr";
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << "nullptr";
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(short val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(int val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned short val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(unsigned int val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(float val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::streambuf *sb) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << sb;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << sb;;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::ios_base& (*func)(std::ios_base&)) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::ostream& (*func)(std::ostream&)) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::_Setfill<char> func)
+{
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::_Setw func)
+{
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << func;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(std::string val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const signed char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const unsigned char* val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const char val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}
+
+SimpleLogger SimpleLogger::operator<<(const unsigned char val) {
+    if (console_enabled) {
+        std::cout << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    }
+    log_stream << (this->log_flag.flag == NO_LOG_STRING ? "" : generateLogString(this->log_flag.flag)) << val;
+    return *this << LogPref::Flag(NO_LOG_STRING);
+}

+ 86 - 0
pico-tcp-service/pico-tcp/src/simplelogger.hpp

@@ -0,0 +1,86 @@
+#include <iostream>
+#include <iomanip>
+#include <chrono>
+#include <ctime>
+#include <sstream>
+#include <fstream>
+#include <sstream>
+#include <fstream>
+
+#define ERROR -1 // Logger flags
+#define WARN 1
+#define INFO 0
+#define NO_LOG_STRING 2
+
+#ifndef SIMPLELOGGER_HPP
+#define SIMPLELOGGER_HPP
+namespace LogPref
+{
+class Flag {
+public:
+    int flag;
+    Flag(int flag) {this->flag = flag;}
+    Flag() {this->flag = INFO;}
+};
+}
+
+namespace LogManip
+{
+std::ostream& setfill(std::ostream out, char c);
+}
+
+class SimpleLogger {
+
+protected:
+    std::ostream& log_stream;
+    std::ofstream file_stream;
+
+    std::string log_name;
+    std::string log_name_prefix;
+    std::string log_string;
+    LogPref::Flag log_flag;
+    bool console_enabled;
+
+    std::string generateFileName();
+    std::string generateLogString(int flag);
+
+public:
+    SimpleLogger(std::ostream& ls, std::string prefix, std::string filename);
+    SimpleLogger(std::ostream& ls, std::string prefix);
+    SimpleLogger(std::ostream& ls);
+    SimpleLogger(const SimpleLogger& other);
+    void initializeLogger(std::string filename, std::string prefix);
+    void closeLogger();
+    void enableConsoleOutput(bool enable_console);
+    void setLoggerFlag(LogPref::Flag log_flag);
+    ~SimpleLogger();
+
+    SimpleLogger operator<<(LogPref::Flag flag);
+    SimpleLogger operator<<(bool val);
+    SimpleLogger operator<<(long val);
+    SimpleLogger operator<<(unsigned long val);
+    SimpleLogger operator<<(long long val);
+    SimpleLogger operator<<(unsigned long long val);
+    SimpleLogger operator<<(double val);
+    SimpleLogger operator<<(long double val);
+    SimpleLogger operator<<(const void* val);
+    SimpleLogger operator<<(std::nullptr_t);
+    SimpleLogger operator<<(short val);
+    SimpleLogger operator<<(int val);
+    SimpleLogger operator<<(unsigned short val);
+    SimpleLogger operator<<(unsigned int val);
+    SimpleLogger operator<<(float val);
+    SimpleLogger operator<<(std::streambuf *sb);
+    SimpleLogger operator<<(std::ios_base& (*func)(std::ios_base&));
+    SimpleLogger operator<<(std::ostream& (*func)(std::ostream&));
+    SimpleLogger operator<<(std::_Setfill<char> func);
+    SimpleLogger operator<<(std::_Setw func);
+    SimpleLogger operator<<(std::string val);
+    SimpleLogger operator<<(const char* val);
+    SimpleLogger operator<<(const signed char* val);
+    SimpleLogger operator<<(const unsigned char* val);
+    SimpleLogger operator<<(const char val);
+    SimpleLogger operator<<(const unsigned char val);
+};
+
+#endif // SIMPLELOGGER_HPP