ads-client 1.14.3 → 2.0.0-beta.1

package/dist/ads-commons.js

@@ -0,0 +1,1247 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.amsAddressToString = exports.encodeStringToPlcWstringBuffer = exports.decodePlcWstringBuffer = exports.encodeStringToPlcStringBuffer = exports.decodePlcStringBuffer = exports.trimPlcString = exports.amsNetIdStrToByteArray = exports.byteArrayToAmsNetIdStr = exports.BASE_DATA_TYPES = exports.AMS_ROUTER_STATE = exports.ADS_RCP_METHOD_PARAM_FLAGS = exports.ADS_RCP_METHOD_FLAGS = exports.ADS_DATA_TYPES = exports.ADS_DATA_TYPE_FLAGS = exports.ADS_SYMBOL_FLAGS_2 = exports.ADS_SYMBOL_FLAGS = exports.ADS_RESERVED_INDEX_GROUPS = exports.ADS_STATE = exports.ADS_TRANS_MODE = exports.ADS_ERROR = exports.ADS_STATE_FLAGS = exports.ADS_COMMAND = exports.ADS_RESERVED_PORTS = exports.AMS_HEADER_FLAG = exports.LOOPBACK_AMS_NET_ID = exports.ADS_DEFAULT_TCP_PORT = exports.ADS_INVOKE_ID_MAX_VALUE = exports.ADS_INDEX_GROUP_LENGTH = exports.ADS_INDEX_OFFSET_LENGTH = exports.AMS_NET_ID_LENGTH = exports.AMS_HEADER_LENGTH = exports.AMS_TCP_HEADER_LENGTH = void 0;
+/*
+Copyright (c) Jussi Isotalo <j.isotalo91@gmail.com>
+
+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.
+*/
+const iconv_lite_1 = __importDefault(require("iconv-lite"));
+/**
+ * AMS/TCP header length
+ */
+exports.AMS_TCP_HEADER_LENGTH = 6;
+/**
+ * AMS header length
+ */
+exports.AMS_HEADER_LENGTH = 32;
+/**
+ * AmsNetId length
+ */
+exports.AMS_NET_ID_LENGTH = 6;
+/**
+ * ADS index offset length
+ */
+exports.ADS_INDEX_OFFSET_LENGTH = 4;
+/**
+ * ADS index group length
+ */
+exports.ADS_INDEX_GROUP_LENGTH = 4;
+/**
+ * ADS invoke ID maximum value (32bit unsigned integer)
+ */
+exports.ADS_INVOKE_ID_MAX_VALUE = 4294967295;
+/**
+ * Default ADS server TCP port for incoming connections
+ */
+exports.ADS_DEFAULT_TCP_PORT = 48898;
+/**
+ * Loopback (localhost) AmsNetId
+ */
+exports.LOOPBACK_AMS_NET_ID = '127.0.0.1.1.1';
+/**
+ * AMS header flag (AMS command)
+ */
+exports.AMS_HEADER_FLAG = {
+    /** 0x0000 - Used for ADS commands */
+    AMS_TCP_PORT_AMS_CMD: 0,
+    /** 0x0001 - Port close command*/
+    AMS_TCP_PORT_CLOSE: 1,
+    /** 0x1000 - Port connect command */
+    AMS_TCP_PORT_CONNECT: 4096,
+    /** 0x1001 - Router notification */
+    AMS_TCP_PORT_ROUTER_NOTE: 4097,
+    /** 0x1002 - Requests local AmsNetId */
+    GET_LOCAL_NETID: 4098,
+    /** Returns the corresponding key as string by given value (number) */
+    toString: function (value) {
+        const val = Object.keys(this).find((key) => this[key] == value);
+        return (val !== undefined ? val : 'UNKNOWN');
+    }
+};
+/**
+ * Reserved/known ADS ports
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_RESERVED_PORTS = {
+    None: 0,
+    /**  AMS Router (Port 1) */
+    Router: 1,
+    /**  AMS Debugger (Port 2) */
+    Debugger: 2,
+    /**  The TCom Server. Dpc or passive level. */
+    R0_TComServer: 10, // 0x0000000A
+    /**  TCom Server Task. RT context. */
+    R0_TComServerTask: 11, // 0x0000000B
+    /**  TCom Serve Task. Passive level. */
+    R0_TComServer_PL: 12, // 0x0000000C
+    /**  TwinCAT Debugger */
+    R0_TcDebugger: 20, // 0x00000014
+    /**  TwinCAT Debugger Task */
+    R0_TcDebuggerTask: 21, // 0x00000015
+    /**  The License Server (Port 30) */
+    R0_LicenseServer: 30, // 0x0000001E
+    /**  Logger (Port 100) */
+    Logger: 100, // 0x00000064
+    /**  Event Logger (Port 110) */
+    EventLog: 110, // 0x0000006E
+    /**  application for coupler (EK), gateway (EL), etc. */
+    DeviceApplication: 120, // 0x00000078
+    /**  Event Logger UM */
+    EventLog_UM: 130, // 0x00000082
+    /**  Event Logger RT */
+    EventLog_RT: 131, // 0x00000083
+    /**  Event Logger Publisher */
+    EventLogPublisher: 132, // 0x00000084
+    /**  R0 Realtime (Port 200) */
+    R0_Realtime: 200, // 0x000000C8
+    /**  R0 Trace (Port 290) */
+    R0_Trace: 290, // 0x00000122
+    /**  R0 IO (Port 300) */
+    R0_IO: 300, // 0x0000012C
+    /**  NC (R0) (Port 500) */
+    R0_NC: 500, // 0x000001F4
+    /**  R0 Satzausführung (Port 501) */
+    R0_NCSAF: 501, // 0x000001F5
+    /**  R0 Satzvorbereitung (Port 511) */
+    R0_NCSVB: 511, // 0x000001FF
+    /**  Preconfigured Nc2-Nc3-Instance */
+    R0_NCINSTANCE: 520, // 0x00000208
+    /**  R0 ISG (Port 550) */
+    R0_ISG: 550, // 0x00000226
+    /**  R0 CNC (Port 600) */
+    R0_CNC: 600, // 0x00000258
+    /**  R0 Line (Port 700) */
+    R0_LINE: 700, // 0x000002BC
+    /**  R0 PLC (Port 800) */
+    R0_PLC: 800, // 0x00000320
+    /**  Tc2 PLC RuntimeSystem 1 (Port 801) */
+    Tc2_Plc1: 801, // 0x00000321
+    /**  Tc2 PLC RuntimeSystem 2 (Port 811) */
+    Tc2_Plc2: 811, // 0x0000032B
+    /**  Tc2 PLC RuntimeSystem 3 (Port 821) */
+    Tc2_Plc3: 821, // 0x00000335
+    /**  Tc2 PLC RuntimeSystem 4 (Port 831) */
+    Tc2_Plc4: 831, // 0x0000033F
+    /**  R0 RTS (Port 850) */
+    R0_RTS: 850, // 0x00000352
+    /**  Tc3 PLC RuntimeSystem 1 (Port 851) */
+    Tc3_Plc1: 851,
+    /**  Tc3 PLC RuntimeSystem 2 (Port 852) */
+    Tc3_Plc2: 852,
+    /**  Tc3 PLC RuntimeSystem 3 (Port 853) */
+    Tc3_Plc3: 853,
+    /**  Tc3 PLC RuntimeSystem 4 (Port 854) */
+    Tc3_Plc4: 854,
+    /**  Tc3 PLC RuntimeSystem 5 (Port 855) */
+    Tc3_Plc5: 855,
+    /**  Camshaft Controller (R0) (Port 900) */
+    CamshaftController: 900, // 0x00000384
+    /**  R0 CAM Tool (Port 950) */
+    R0_CAMTOOL: 950, // 0x000003B6
+    /**  R0 User (Port 2000) */
+    R0_USER: 2000, // 0x000007D0
+    /**  (Port 10000) */
+    R3_CTRLPROG: 10000, // 0x00002710
+    /**  System Service (AMSPORT_R3_SYSSERV, 10000) */
+    SystemService: 10000, // 0x00002710
+    /**  (Port 10001) */
+    R3_SYSCTRL: 10001, // 0x00002711
+    /**  Port 10100 */
+    R3_SYSSAMPLER: 10100, // 0x00002774
+    /**  Port 10200 */
+    R3_TCPRAWCONN: 10200, // 0x000027D8
+    /**  Port 10201 */
+    R3_TCPIPSERVER: 10201, // 0x000027D9
+    /**  Port 10300 */
+    R3_SYSMANAGER: 10300, // 0x0000283C
+    /**  Port 10400 */
+    R3_SMSSERVER: 10400, // 0x000028A0
+    /**  Port 10500 */
+    R3_MODBUSSERVER: 10500, // 0x00002904
+    /**  Port 10502 */
+    R3_AMSLOGGER: 10502, // 0x00002906
+    /**  Port 10600 */
+    R3_XMLDATASERVER: 10600, // 0x00002968
+    /**  Port 10700 */
+    R3_AUTOCONFIG: 10700, // 0x000029CC
+    /**  Port 10800 */
+    R3_PLCCONTROL: 10800, // 0x00002A30
+    /**  Port 10900 */
+    R3_FTPCLIENT: 10900, // 0x00002A94
+    /**  Port 11000 */
+    R3_NCCTRL: 11000, // 0x00002AF8
+    /**  Port 11500 */
+    R3_NCINTERPRETER: 11500, // 0x00002CEC
+    /**  Port 11600 */
+    R3_GSTINTERPRETER: 11600, // 0x00002D50
+    /**  Port 12000 */
+    R3_STRECKECTRL: 12000, // 0x00002EE0
+    /**  Port 13000 */
+    R3_CAMCTRL: 13000, // 0x000032C8
+    /**  Port 14000 */
+    R3_SCOPE: 14000, // 0x000036B0
+    /**  Port 14100 */
+    R3_CONDITIONMON: 14100, // 0x00003714
+    /**  Port 15000 */
+    R3_SINECH1: 15000, // 0x00003A98
+    /**  Port 16000 */
+    R3_CONTROLNET: 16000, // 0x00003E80
+    /**  Port 17000 */
+    R3_OPCSERVER: 17000, // 0x00004268
+    /**  Port 17500 */
+    R3_OPCCLIENT: 17500, // 0x0000445C
+    /**  Port 18000 */
+    R3_MAILSERVER: 18000, // 0x00004650
+    /**  Port 19000 */
+    R3_EL60XX: 19000, // 0x00004A38
+    /**  Port 19100 */
+    R3_MANAGEMENT: 19100, // 0x00004A9C
+    /**  Port 19200 */
+    R3_MIELEHOME: 19200, // 0x00004B00
+    /**  Port 19300 */
+    R3_CPLINK3: 19300, // 0x00004B64
+    /**  Port 19500 */
+    R3_VNSERVICE: 19500, // 0x00004C2C
+    /**  Multiuser (Port 19600) */
+    R3_MULTIUSER: 19600, // 0x00004C90
+    /**  Default (AMS router assigns) */
+    USEDEFAULT: 65535, // 0x0000FFFF
+};
+/**
+ * ADS command
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_COMMAND = {
+    /**  Invalid */
+    Invalid: 0,
+    /**  None / Uninitialized */
+    None: 0,
+    /**  ReadDeviceInfo command */
+    ReadDeviceInfo: 1,
+    /**  Read Command */
+    Read: 2,
+    /**  Write Command */
+    Write: 3,
+    /**  ReadState Command */
+    ReadState: 4,
+    /**  WriteControl Command */
+    WriteControl: 5,
+    /**  AddNotification Command */
+    AddNotification: 6,
+    /**  DeleteNotification Command */
+    DeleteNotification: 7,
+    /**  Notification event. */
+    Notification: 8,
+    /**  ReadWrite Command */
+    ReadWrite: 9,
+    /** Returns the corresponding key as string by given value (number) */
+    toString: function (value) {
+        const val = Object.keys(this).find((key) => this[key] == value);
+        return (val !== undefined ? val : 'UNKNOWN');
+    }
+};
+/**
+ * ADS state flags
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_STATE_FLAGS = {
+    //The response (AMSCMDSF_RESPONSE)
+    Response: 1,
+    /**  (AMSCMDSF_NORETURN) */
+    NoReturn: 2,
+    /**  AdsCommand */
+    AdsCommand: 4,
+    /**  Internal generated cmds (AMSCMDSF_SYSCMD) */
+    SysCommand: 8,
+    /**  High Priority (R0 to R0 checked at task begin, AMSCMDSF_HIGHPRIO) */
+    HighPriority: 16, // 0x0010
+    /**  (cbData um 8 Byte vergrößert, AMSCMDSF_TIMESTAMPADDED) */
+    TimeStampAdded: 32, // 0x0020
+    /**  (UDP instead of TCP, AMSCMDSF_UDP) */
+    Udp: 64, // 0x0040
+    /**  (command during init phase of TwinCAT, AMSCMDSF_INITCMD) */
+    InitCmd: 128, // 0x0080
+    /**  (AMSCMDSF_BROADCAST) */
+    Broadcast: 32768, // 0x8000
+    /** Returns the flags as comma separated list by given flag value (number) */
+    toString: function (value) {
+        const flags = [];
+        for (const key of Object.keys(this)) {
+            const typedKey = key;
+            if (typeof this[typedKey] !== 'number')
+                continue;
+            if ((value & this[typedKey]) === this[typedKey])
+                flags.push(key);
+        }
+        //Specials: For helping debugging
+        if (!flags.includes('Udp'))
+            flags.push('Tcp');
+        if (!flags.includes('Response'))
+            flags.push('Request');
+        return flags.join(', ');
+    }
+};
+/**
+ * ADS error code
+ *
+ * Source: Beckhoff InfoSys
+ */
+exports.ADS_ERROR = {
+    0: 'No error',
+    1: 'Internal error',
+    2: 'No Rtime',
+    3: 'Allocation locked memory error',
+    4: 'Insert mailbox error',
+    5: 'Wrong receive HMSG',
+    6: 'Target port not found',
+    7: 'Target machine not found',
+    8: 'Unknown command ID',
+    9: 'Bad task ID',
+    10: 'No IO',
+    11: 'Unknown ADS command',
+    12: 'Win 32 error',
+    13: 'Port not connected',
+    14: 'Invalid ADS length',
+    15: 'Invalid AMS Net ID',
+    16: 'Low Installation level',
+    17: 'No debug available',
+    18: 'Port disabled',
+    19: 'Port already connected',
+    20: 'ADS Sync Win32 error',
+    21: 'ADS Sync Timeout',
+    22: 'ADS Sync AMS error',
+    23: 'ADS Sync no index map',
+    24: 'Invalid ADS port',
+    25: 'No memory',
+    26: 'TCP send error',
+    27: 'Host unreachable',
+    28: 'Invalid AMS fragment',
+    1280: 'No locked memory can be allocated',
+    1281: 'The size of the router memory could not be changed',
+    1282: 'The mailbox has reached the maximum number of possible messages. The current sent message was rejected',
+    1283: 'The mailbox has reached the maximum number of possible messages.',
+    1284: 'Unknown port type',
+    1285: 'Router is not initialized',
+    1286: 'The desired port number is already assigned',
+    1287: 'Port not registered',
+    1288: 'The maximum number of Ports reached',
+    1289: 'Invalid port',
+    1290: 'TwinCAT Router not active',
+    1792: 'General device error',
+    1793: 'Service is not supported by server',
+    1794: 'Invalid index group',
+    1795: 'Invalid index offset',
+    1796: 'Reading/writing not permitted',
+    1797: 'Parameter size not correct',
+    1798: 'Invalid parameter value(s)',
+    1799: 'Device is not in a ready state',
+    1800: 'Device is busy',
+    1801: 'Invalid context (must be in Windows)',
+    1802: 'Out of memory',
+    1803: 'Invalid parameter value(s)',
+    1804: 'Not found (files, ...)',
+    1805: 'Syntax error in command or file',
+    1806: 'Objects do not match',
+    1807: 'Object already exists',
+    1808: 'Symbol not found',
+    1809: 'Symbol version invalid',
+    1810: 'Server is in invalid state',
+    1811: 'AdsTransMode not supported',
+    1812: 'Notification handle is invalid',
+    1813: 'Notification client not registered',
+    1814: 'No more notification handles',
+    1815: 'Size for watch too big',
+    1816: 'Device not initialized',
+    1817: 'Device has a timeout',
+    1818: 'Query interface failed',
+    1819: 'Wrong interface required',
+    1820: 'Class ID is invalid',
+    1821: 'Object ID is invalid',
+    1822: 'Request is pending',
+    1823: 'Request is aborted',
+    1824: 'Signal warning',
+    1825: 'Invalid array index',
+    1826: 'Symbol not active',
+    1827: 'Access denied',
+    1828: 'Missing license',
+    1829: 'License expired',
+    1830: 'License exceeded',
+    1831: 'License invalid',
+    1832: 'License invalid system id',
+    1833: 'License not time limited',
+    1834: 'License issue time in the future',
+    1835: 'License time period to long',
+    1836: 'Exception occured during system start',
+    1837: 'License file read twice',
+    1838: 'Invalid signature',
+    1839: 'Public key certificate',
+    1856: 'Error class <client error>',
+    1857: 'Invalid parameter at service',
+    1858: 'Polling list is empty',
+    1859: 'Var connection already in use',
+    1860: 'Invoke ID in use',
+    1861: 'Timeout elapsed',
+    1862: 'Error in win32 subsystem',
+    1863: 'Invalid client timeout value',
+    1864: 'Ads-port not opened',
+    1872: 'Internal error in ads sync',
+    1873: 'Hash table overflow',
+    1874: 'Key not found in hash',
+    1875: 'No more symbols in cache',
+    1876: 'Invalid response received',
+    1877: 'Sync port is locked',
+    4096: 'Internal fatal error in the TwinCAT real-time system',
+    4097: 'Timer value not vaild',
+    4098: 'Task pointer has the invalid value ZERO',
+    4099: 'Task stack pointer has the invalid value ZERO',
+    4100: 'The demand task priority is already assigned',
+    4101: 'No more free TCB (Task Control Block) available. Maximum number of TCBs is 64',
+    4102: 'No more free semaphores available. Maximum number of semaphores is 64',
+    4103: 'No more free queue available. Maximum number of queue is 64',
+    4109: 'An external synchronization interrupt is already applied',
+    4110: 'No external synchronization interrupt applied',
+    4111: 'The apply of the external synchronization interrupt failed',
+    4112: 'Call of a service function in the wrong context',
+    4119: 'Intel VT-x extension is not supported',
+    4120: 'Intel VT-x extension is not enabled in system BIOS',
+    4121: 'Missing function in Intel VT-x extension',
+    4122: 'Enabling Intel VT-x fails',
+};
+/**
+ * ADS notification transmission mode
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_TRANS_MODE = {
+    None: 0,
+    ClientCycle: 1,
+    ClientOnChange: 2,
+    Cyclic: 3,
+    OnChange: 4,
+    CyclicInContext: 5,
+    OnChangeInContext: 6,
+    /** Returns the corresponding key as string by given value (number) */
+    toString: function (value) {
+        const val = Object.keys(this).find((key) => this[key] == value);
+        return (val !== undefined ? val : 'UNKNOWN');
+    }
+};
+/**
+ * ADS state
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_STATE = {
+    Invalid: 0,
+    Idle: 1,
+    Reset: 2,
+    Initialize: 3,
+    Start: 4,
+    Run: 5,
+    Stop: 6,
+    SaveConfig: 7,
+    LoadConfig: 8,
+    PowerFailure: 9,
+    PowerGood: 10,
+    Error: 11,
+    Shutdown: 12,
+    Suspend: 13,
+    Resume: 14,
+    Config: 15,
+    Reconfig: 16,
+    Stopping: 17,
+    Incompatible: 18,
+    Exception: 19,
+    /** Returns the corresponding key as string by given value (number) */
+    toString: function (value) {
+        const val = Object.keys(this).find((key) => this[key] == value);
+        return (val !== undefined ? val : 'UNKNOWN');
+    }
+};
+/**
+ * Reserved ADS index groups
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_RESERVED_INDEX_GROUPS = {
+    /**  PlcRWIB (0x4000, 16384) */
+    PlcRWIB: 16384, // 0x00004000
+    /**  PlcRWOB (0x4010, 16400) */
+    PlcRWOB: 16400, // 0x00004010
+    /**  PlcRWMB (0x4020, 16416) */
+    PlcRWMB: 16416, // 0x00004020
+    /**  PlcRWRB (0x4030, 16432) */
+    PlcRWRB: 16432, // 0x00004030
+    /**  PlcRWDB (0x4040,16448) */
+    PlcRWDB: 16448, // 0x00004040
+    /**  SymbolTable (0xF000, 61440) */
+    SymbolTable: 61440, // 0x0000F000
+    /**  SymbolName (0xF001, 61441) */
+    SymbolName: 61441, // 0x0000F001
+    /**  SymbolValue (0xF002, 61442) */
+    SymbolValue: 61442, // 0x0000F002
+    /**  SymbolHandleByName (0xF003, 61443) */
+    SymbolHandleByName: 61443, // 0x0000F003
+    /**  SymbolValueByName (0xF004, 61444) */
+    SymbolValueByName: 61444, // 0x0000F004
+    /**  SymbolValueByHandle (0xF005, 61445) */
+    SymbolValueByHandle: 61445, // 0x0000F005
+    /**  SymbolReleaseHandle (0xF006, 61446) */
+    SymbolReleaseHandle: 61446, // 0x0000F006
+    /**  SymbolInfoByName (0xF007, 61447) */
+    SymbolInfoByName: 61447, // 0x0000F007
+    /**  SymbolVersion (0xF008, 61448) */
+    SymbolVersion: 61448, // 0x0000F008
+    /**  SymbolInfoByNameEx (0xF009, 61449) */
+    SymbolInfoByNameEx: 61449, // 0x0000F009
+    /**  SymbolDownload (F00A, 61450) */
+    SymbolDownload: 61450, // 0x0000F00A
+    /**  SymbolUpload (F00B, 61451) */
+    SymbolUpload: 61451, // 0x0000F00B
+    /**  SymbolUploadInfo (0xF00C, 61452) */
+    SymbolUploadInfo: 61452, // 0x0000F00C
+    /**  SymbolDownload2 */
+    SymbolDownload2: 0xF00D, //Added, not from .dll
+    /**  SymbolDataTypeUpload */
+    SymbolDataTypeUpload: 0xF00E, //Added, not from .dll
+    /**  SymbolUploadInfo2 */
+    SymbolUploadInfo2: 0xF00F, //Added, not from .dll - 24 bytes of info, uploadinfo3 would contain 64 bytes
+    /**  Notification of named handle (0xF010, 61456) */
+    SymbolNote: 61456, // 0x0000F010
+    /**  DataDataTypeInfoByNameEx */
+    DataDataTypeInfoByNameEx: 0xF011, //Added, not from .dll
+    /**  read/write input byte(s) (0xF020, 61472) */
+    IOImageRWIB: 61472, // 0x0000F020
+    /**  read/write input bit (0xF021, 61473) */
+    IOImageRWIX: 61473, // 0x0000F021
+    /**  read/write output byte(s) (0xF030, 61488) */
+    IOImageRWOB: 61488, // 0x0000F030
+    /**  read/write output bit (0xF031, 61489) */
+    IOImageRWOX: 61489, // 0x0000F031
+    /**  write inputs to null (0xF040, 61504) */
+    IOImageClearI: 61504, // 0x0000F040
+    /**  write outputs to null (0xF050, 61520) */
+    IOImageClearO: 61520, // 0x0000F050
+    /**  ADS Sum Read Command (ADSIGRP_SUMUP_READ, 0xF080, 61568) */
+    SumCommandRead: 61568, // 0x0000F080
+    /**  ADS Sum Write Command (ADSIGRP_SUMUP_WRITE, 0xF081, 61569) */
+    SumCommandWrite: 61569, // 0x0000F081
+    /**  ADS sum Read/Write command (ADSIGRP_SUMUP_READWRITE, 0xF082, 61570) */
+    SumCommandReadWrite: 61570, // 0x0000F082
+    /**  ADS sum ReadEx command (ADSIGRP_SUMUP_READEX, 0xF083, 61571) */
+    /**  AdsRW  IOffs list size */
+    /**  W: {list of IGrp, IOffs, Length} */
+    /**  R: {list of results, Length} followed by {list of data (expepted lengths)} */
+    SumCommandReadEx: 61571, // 0x0000F083
+    /**  ADS sum ReadEx2 command (ADSIGRP_SUMUP_READEX2, 0xF084, 61572) */
+    /**  AdsRW  IOffs list size */
+    /**  W: {list of IGrp, IOffs, Length} */
+    /**  R: {list of results, Length} followed by {list of data (returned lengths)} */
+    SumCommandReadEx2: 61572, // 0x0000F084
+    /**  ADS sum AddDevNote command (ADSIGRP_SUMUP_ADDDEVNOTE, 0xF085, 61573) */
+    /**  AdsRW  IOffs list size */
+    /**  W: {list of IGrp, IOffs, Attrib} */
+    /**  R: {list of results, handles} */
+    SumCommandAddDevNote: 61573, // 0x0000F085
+    /**  ADS sum DelDevNot command (ADSIGRP_SUMUP_DELDEVNOTE, 0xF086, 61574) */
+    /**  AdsRW  IOffs list size */
+    /**  W: {list of handles} */
+    /**  R: {list of results} */
+    SumCommandDelDevNote: 61574, // 0x0000F086
+    /**  DeviceData (0xF100,61696) */
+    DeviceData: 61696, // 0x0000F100
+    /** Returns the corresponding key as string by given value (number) */
+    toString: function (value) {
+        const val = Object.keys(this).find((key) => this[key] == value);
+        return (val !== undefined ? val : 'UNKNOWN');
+    }
+};
+/**
+ * ADS symbol flags
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_SYMBOL_FLAGS = {
+    //None
+    None: 0,
+    /**  ADSSYMBOLFLAG_PERSISTENT */
+    Persistent: 1,
+    /**  ADSSYMBOLFLAG_BITVALUE */
+    BitValue: 2,
+    /**  ADSSYMBOLFLAG_REFERENCETO */
+    ReferenceTo: 4,
+    /**  ADSSYMBOLFLAG_TYPEGUID */
+    TypeGuid: 8,
+    /**  ADSSYMBOLFLAG_TCCOMIFACEPTR */
+    TComInterfacePtr: 16, // 0x0010
+    /**  ADSSYMBOLFLAG_READONLY */
+    ReadOnly: 32, // 0x0020
+    /**  ADSSYMBOLFLAG_ITFMETHODACCESS */
+    ItfMethodAccess: 64, // 0x0040
+    /**  ADSSYMBOLFLAG_METHODDEREF */
+    MethodDeref: 128, // 0x0080
+    /**  ADSSYMBOLFLAG_CONTEXTMASK (4 Bit) */
+    ContextMask: 3840, // 0x0F00
+    /**  ADSSYMBOLFLAG_ATTRIBUTES */
+    Attributes: 4096, // 0x1000
+    /**   Symbol is static (ADSSYMBOLFLAG_STATIC,0x2000) */
+    Static: 8192, // 0x2000
+    /**   Persistent data will not restored after reset (cold, ADSSYMBOLFLAG_INITONRESET 0x4000) */
+    InitOnReset: 16384, // 0x4000
+    /**   Extended Flags in symbol (ADSSYMBOLFLAG_EXTENDEDFLAGS,0x8000) */
+    ExtendedFlags: 32768, // 0x8000
+    /** Return given flag value as string array */
+    toStringArray: function (flags) {
+        const flagsArr = [];
+        for (const key of Object.keys(this)) {
+            const typedKey = key;
+            if (typeof this[typedKey] !== 'number')
+                continue;
+            //Check if flag is available
+            if ((flags & this[typedKey]) === this[typedKey]) {
+                if (flags === 0 || this[typedKey] !== 0)
+                    flagsArr.push(key);
+            }
+        }
+        return flagsArr;
+    },
+    toString: function (flag) {
+        const index = Object.values(this).findIndex(val => val === flag);
+        return index >= 0 ? Object.keys(this)[index] : "unknown";
+    }
+};
+/**
+ * ADS symbol extended flags
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_SYMBOL_FLAGS_2 = {
+    //None
+    None: 0,
+    /**  PLC pointer type (ADSSYMBOLFLAG2_PLCPOINTERTYPE, 0x00000001) */
+    PlcPointerType: 1,
+    /**  Ignore symbol while equalizing redundancy projects (ADSSYMBOLFLAG2_RDIGNORE, 0x00000002) */
+    RedundancyIgnore: 2,
+    /**  Contains refactoring information (ADSSYMBOLFLAG2_REFACTORINFO, 0x00000004) */
+    RefactorInfo: 4,
+    /**  Online change PTR reference type (ADSSYMBOLFLAG2_OCPTRREFTYPE, 0x00000008) */
+    OnlineChangePtrRefType: 8,
+    /**  Symbol is a Variant Type (ADSSYMBOLFLAG2_VARIANT, 0x00000010) */
+    VariantType: 16, // 0x0010
+    /** Return given flag value as string array */
+    toStringArray: function (flags) {
+        const flagsArr = [];
+        for (const key of Object.keys(this)) {
+            const typedKey = key;
+            if (typeof this[typedKey] !== 'number')
+                continue;
+            //Check if flag is available
+            if ((flags & this[typedKey]) === this[typedKey]) {
+                if (flags === 0 || this[typedKey] !== 0)
+                    flagsArr.push(key);
+            }
+        }
+        return flagsArr;
+    },
+    toString: function (flag) {
+        const index = Object.values(this).findIndex(val => val === flag);
+        return index >= 0 ? Object.keys(this)[index] : "unknown";
+    }
+};
+/**
+ * ADS data type flags
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_DATA_TYPE_FLAGS = {
+    /**  ADSDATATYPEFLAG_DATATYPE */
+    DataType: 1,
+    /**  ADSDATATYPEFLAG_DATAITEM */
+    DataItem: 2,
+    /**  ADSDATATYPEFLAG_REFERENCETO */
+    ReferenceTo: 4,
+    /**  ADSDATATYPEFLAG_METHODDEREF */
+    MethodDeref: 8,
+    /**  ADSDATATYPEFLAG_OVERSAMPLE */
+    Oversample: 16, // 0x00000010
+    /**  ADSDATATYPEFLAG_BITVALUES */
+    BitValues: 32, // 0x00000020
+    /**  ADSDATATYPEFLAG_PROPITEM */
+    PropItem: 64, // 0x00000040
+    /**  ADSDATATYPEFLAG_TYPEGUID */
+    TypeGuid: 128, // 0x00000080
+    /**  ADSDATATYPEFLAG_PERSISTENT */
+    Persistent: 256, // 0x00000100
+    /**  ADSDATATYPEFLAG_COPYMASK */
+    CopyMask: 512, // 0x00000200
+    /**  ADSDATATYPEFLAG_TCCOMIFACEPTR */
+    TComInterfacePtr: 1024, // 0x00000400
+    /**  ADSDATATYPEFLAG_METHODINFOS */
+    MethodInfos: 2048, // 0x00000800
+    /**  ADSDATATYPEFLAG_ATTRIBUTES */
+    Attributes: 4096, // 0x00001000
+    /**  ADSDATATYPEFLAG_ENUMINFOS */
+    EnumInfos: 8192, // 0x00002000
+    /**   this flag is set if the datatype is aligned (ADSDATATYPEFLAG_ALIGNED) */
+    Aligned: 65536, // 0x00010000
+    /**   data item is static - do not use offs (ADSDATATYPEFLAG_STATIC) */
+    Static: 131072, // 0x00020000
+    /** Has Software Protection Levels for DataTypes. */
+    SoftwareProtectionLevels: 262144, // 0x00040000
+    /**   do not restore persistent data (ADSDATATYPEFLAG_IGNOREPERSIST) */
+    IgnorePersist: 524288, // 0x00080000
+    /**  Any size array (ADSDATATYPEFLAG_ANYSIZEARRAY) */
+    AnySizeArray: 1048576, // 0x00100000
+    /**    data type used for persistent variables -&gt; should be saved with persistent data (ADSDATATYPEFLAG_PERSIST_DT,0x00200000) */
+    PersistantDatatype: 2097152, // 0x00200000
+    /**   Persistent data will not restored after reset (cold) (ADSDATATYPEFLAG_INITONRESET,0x00400000) */
+    InitOnReset: 4194304, // 0x00400000
+    /** Indicates PLC Pointer types (ADSDATATYPEFLAG_PLCPOINTERTYPE, 0x00800000) */
+    PlcPointerType: 8388608, // 0x00800000
+    /** Refactoring information is added (ADSDATATYPEFLAG_REFACTORINFO, 0x01000000) */
+    RefactorInfo: 16777216, // 0x01000000
+    /** SubItems are hidden / will not be evaluated (ADSDATATYPEFLAG_HIDESUBITEMS, 0x02000000) */
+    HideSubItems: 33554432, // 0x02000000
+    /** The Type description is incomplete (ADSDATATYPEFLAG_INCOMPLETE, 0x04000000) */
+    Incomplete: 67108864, // 0x04000000
+    /** Type contains online change PTR reference (ADSDATATYPEFLAG_OCPTRREFTYPE, 0x08000000) */
+    ContainsOnlineChangePtrRef: 134217728, // 0x08000000
+    /** Deref Type Item (ADSDATATYPEFLAG_DEREFTYPEITEM, 0x10000000) */
+    DeRefTypeItem: 268435456, // 0x10000000
+    /** Extended Enum Infos. Comment and attributes for enum values (ADSDATATYPEFLAG_EXTENUMINFOS, 0x20000000) */
+    ExtendedEnumInfos: 536870912, // 0x20000000
+    /** Extended Flags used/added (ADSDATATYPEFLAG_EXTENDEDFLAGS, 0x80000000) */
+    ExtendedFlags: 2147483648, // 0x80000000
+    /**  None / No Flag set */
+    None: 0,
+    /** Return given flag value as string array */
+    toStringArray: function (flags) {
+        const flagsArr = [];
+        for (const key of Object.keys(this)) {
+            const typedKey = key;
+            if (typeof this[typedKey] !== 'number')
+                continue;
+            //Check if flag is available
+            if ((flags & this[typedKey]) === this[typedKey]) {
+                if (flags === 0 || this[typedKey] !== 0)
+                    flagsArr.push(key);
+            }
+        }
+        return flagsArr;
+    }
+};
+/**
+ * ADS data types
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_DATA_TYPES = {
+    /** Empty Type*/
+    ADST_VOID: 0,
+    /**Integer 16 Bit*/
+    ADST_INT16: 2,
+    /**Integer 32 Bit*/
+    ADST_INT32: 3,
+    /**Real (32 Bit)*/
+    ADST_REAL32: 4,
+    /**Real 64 Bit*/
+    ADST_REAL64: 5,
+    /**Integer 8 Bit*/
+    ADST_INT8: 16, // 0x00000010
+    /**Unsigned integer 8 Bit*/
+    ADST_UINT8: 17, // 0x00000011
+    /**Unsigned integer 16 Bit*/
+    ADST_UINT16: 18, // 0x00000012
+    /**Unsigned Integer 32 Bit*/
+    ADST_UINT32: 19, // 0x00000013
+    /**LONG Integer 64 Bit*/
+    ADST_INT64: 20, // 0x00000014
+    /**Unsigned Long integer 64 Bit*/
+    ADST_UINT64: 21, // 0x00000015
+    /**STRING*/
+    ADST_STRING: 30, // 0x0000001E
+    /**WSTRING*/
+    ADST_WSTRING: 31, // 0x0000001F
+    /**ADS REAL80*/
+    ADST_REAL80: 32, // 0x00000020
+    /**ADS BIT*/
+    ADST_BIT: 33, // 0x00000021
+    /**Internal Only*/
+    ADST_MAXTYPES: 34, // 0x00000022
+    /**Blob*/
+    ADST_BIGTYPE: 65, // 0x00000041
+    /** Returns the corresponding key as string by given value (number) */
+    toString: function (value) {
+        const val = Object.keys(this).find((key) => this[key] == value);
+        return (val !== undefined ? val : 'UNKNOWN');
+    }
+};
+/**
+ * ADS RCP method flags
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_RCP_METHOD_FLAGS = {
+    /**  (ADSMETHODFLAG_PLC_CALLINGCONVENTION, 0x00000001) */
+    PlcCallingConvention: 1,
+    /**  (ADSMETHODFLAG_CALL_UNLOCKED, 0x00000002) */
+    CallUnlocked: 2,
+    /**  (ADSMETHODFLAG_NOTCALLABLE, 0x00000004) */
+    NotCallable: 4,
+    /**  (ADSMETHODFLAG_ATTRIBUTES, 0x00000008) */
+    Attributes: 8,
+    /** Return given flag value as string array */
+    toStringArray: function (flags) {
+        const flagsArr = [];
+        for (const key of Object.keys(this)) {
+            const typedKey = key;
+            if (typeof this[typedKey] !== 'number')
+                continue;
+            //Check if flag is available
+            if ((flags & this[typedKey]) === this[typedKey]) {
+                if (flags === 0 || this[typedKey] !== 0)
+                    flagsArr.push(key);
+            }
+        }
+        return flagsArr;
+    }
+};
+/**
+ * ADS RCP method parameter flags
+ *
+ * Source: TwinCAT.Ads.dll By Beckhoff
+ */
+exports.ADS_RCP_METHOD_PARAM_FLAGS = {
+    /**  Input Parameter (ADSMETHODPARAFLAG_IN) */
+    In: 1,
+    /**  Output Parameter (ADSMETHODPARAFLAG_OUT) */
+    Out: 2,
+    /**
+     * By reference Parameter (ADSMETHODPARAFLAG_BYREFERENCE)
+     * This flag indicates parameters that are transfered as REFERENCE or POINTER Types.
+    */
+    ByReference: 4,
+    /** (ADSMETHODPARAFLAG_RPC_OUTPTR, 0x00000008) */
+    RpcOutPtr: 4,
+    /** (ADSMETHODPARAFLAG_RPC_ARRAYDIM_MASK,0x00000030) */
+    MaskRpcArrayDim: 48,
+    /** Attributes (ADSMETHODPARAFLAG_ATTRIBUTES, 0x00000040)*/
+    Attributes: 64,
+    /** Return given flag value as string array */
+    toStringArray: function (flags) {
+        const flagsArr = [];
+        for (const key of Object.keys(this)) {
+            const typedKey = key;
+            if (typeof this[typedKey] !== 'number')
+                continue;
+            //Check if flag is available
+            if ((flags & this[typedKey]) === this[typedKey]) {
+                if (flags === 0 || this[typedKey] !== 0)
+                    flagsArr.push(key);
+            }
+        }
+        return flagsArr;
+    }
+};
+/**
+ * AMS router state
+ */
+exports.AMS_ROUTER_STATE = {
+    /** Router is stopped */
+    STOP: 0,
+    /** Router is started */
+    START: 1,
+    /** Router is remove (unavailable?) */
+    REMOVED: 2,
+    /** Returns the corresponding key as string by given value (number) */
+    toString: function (value) {
+        const val = Object.keys(this).find((key) => this[key] == value);
+        return (val !== undefined ? val : 'UNKNOWN');
+    }
+};
+/**
+ * Base data types
+ *
+ * Object that handles PLC base data types
+ */
+exports.BASE_DATA_TYPES = {
+    /**
+     * Returns true if given data type is found and known
+     *
+     * @param name Data type name
+     */
+    isKnownType: function (name) {
+        return this.find(name.trim()) !== null;
+    },
+    /**
+     * Finds the given data type from array
+     *
+     * @param name Data type name
+     */
+    find: function (name) {
+        let regExpRes = null;
+        //First, try to find easy way
+        let type = this.types.find(type => type.name.includes(name.toUpperCase()));
+        if (!type) {
+            //Not found, try to find the correct type with regular expressions
+            //We can find also STRING(xx), WSTRING(xx) and DWORD(100..2000) for example
+            type = this.types.find(type => {
+                const re = new RegExp('^(' + type.name.join('|') + ')([\\[\\(](.*)[\\)\\]])*$', 'i');
+                //Using match instead of test so we get capture groups too
+                regExpRes = name.trim().match(re);
+                return (regExpRes != null);
+            });
+        }
+        if (!type) {
+            return null;
+        }
+        //We are here -> type is found
+        //If string/wstring, regExpRes[3] is the string length -> use it
+        if (type.adsDataType === exports.ADS_DATA_TYPES.ADST_STRING) {
+            if (regExpRes === null) {
+                return null;
+            }
+            type.size = (regExpRes[3] != null ? (parseInt(regExpRes[3]) + 1) : type.size);
+        }
+        else if (type.adsDataType === exports.ADS_DATA_TYPES.ADST_WSTRING) {
+            if (regExpRes === null) {
+                return null;
+            }
+            type.size = (regExpRes[3] != null ? (parseInt(regExpRes[3]) * 2 + 2) : type.size);
+        }
+        return type;
+    },
+    /**
+     * Writes given value to given or new buffer
+     *
+     * @param name Data type name
+     * @param value Value to write
+     * @param buffer Optional - Buffer to write to. If not given, new Buffer is allocated
+     */
+    toBuffer: function (name, value, buffer) {
+        const type = this.find(name);
+        if (!type) {
+            throw new Error(`Error: Base type ${name} not found from BaseDataTypes - If this should be found, report an issue`);
+        }
+        //If buffer not given, allocate new
+        if (buffer === undefined) {
+            buffer = Buffer.allocUnsafe(type.size);
+        }
+        type.toBuffer(value, buffer);
+        return buffer;
+    },
+    /**
+     * Reads given data type from given buffer
+     *
+     * @param {string} name Data type name
+     * @param {Buffer} buffer Buffer to read from
+     */
+    fromBuffer: function (name, buffer, convertDates) {
+        const type = this.find(name);
+        if (!type) {
+            throw new Error(`Error: Base type ${name} not found from BaseDataTypes - If this should be found, report an issue`);
+        }
+        return type.fromBuffer(buffer, convertDates);
+    },
+    /**
+     * All base data types and properties
+     */
+    types: [
+        {
+            name: ['STRING'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_STRING,
+            size: 81, //Just default size
+            toBuffer: (value, buffer) => (0, exports.encodeStringToPlcStringBuffer)(value).copy(buffer),
+            fromBuffer: (buffer) => (0, exports.decodePlcStringBuffer)(buffer)
+        },
+        {
+            name: ['WSTRING'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_WSTRING,
+            size: 162, //Just default size
+            toBuffer: (value, buffer) => (0, exports.encodeStringToPlcWstringBuffer)(value).copy(buffer),
+            fromBuffer: (buffer) => (0, exports.decodePlcWstringBuffer)(buffer)
+        },
+        {
+            name: ['BOOL', 'BIT', 'BIT8'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_BIT,
+            size: 1,
+            toBuffer: (value, buffer) => buffer.writeUInt8(value ? 1 : 0),
+            fromBuffer: (buffer) => buffer.readUInt8(0) !== 0
+        },
+        {
+            name: ['BYTE', 'USINT', 'BITARR8', 'UINT8'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_UINT8,
+            size: 1,
+            toBuffer: (value, buffer) => buffer.writeUInt8(value),
+            fromBuffer: (buffer) => buffer.readUInt8(0)
+        },
+        {
+            name: ['SINT', 'INT8'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_INT8,
+            size: 1,
+            toBuffer: (value, buffer) => buffer.writeInt8(value),
+            fromBuffer: (buffer) => buffer.readInt8(0)
+        },
+        {
+            name: ['UINT', 'WORD', 'BITARR16', 'UINT16'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_UINT16,
+            size: 2,
+            toBuffer: (value, buffer) => buffer.writeUInt16LE(value),
+            fromBuffer: (buffer) => buffer.readUInt16LE(0)
+        },
+        {
+            name: ['INT', 'INT16'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_INT16,
+            size: 2,
+            toBuffer: (value, buffer) => buffer.writeInt16LE(value),
+            fromBuffer: (buffer) => buffer.readInt16LE(0)
+        },
+        {
+            name: ['DINT', 'INT32'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_INT32,
+            size: 4,
+            toBuffer: (value, buffer) => buffer.writeInt32LE(value),
+            fromBuffer: (buffer) => buffer.readInt32LE(0)
+        },
+        {
+            name: ['UDINT', 'DWORD', 'TIME', 'TIME_OF_DAY', 'TOD', 'BITARR32', 'UINT32'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_UINT32,
+            size: 4,
+            toBuffer: (value, buffer) => buffer.writeUInt32LE(value),
+            fromBuffer: (buffer) => buffer.readUInt32LE(0)
+        },
+        {
+            name: ['DATE_AND_TIME', 'DT', 'DATE'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_UINT32,
+            size: 4,
+            toBuffer: (value, buffer) => {
+                if (typeof value === 'object' && value.getTime !== undefined) {
+                    buffer.writeUInt32LE(value.getTime() / 1000);
+                }
+                else {
+                    buffer.writeUInt32LE(value);
+                }
+            },
+            fromBuffer: (buffer, convertDates) => {
+                if (convertDates) {
+                    return new Date(buffer.readUInt32LE(0) * 1000);
+                }
+                else {
+                    return buffer.readUInt32LE(0);
+                }
+            }
+        },
+        {
+            name: ['REAL', 'FLOAT'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_REAL32,
+            size: 4,
+            toBuffer: (value, buffer) => buffer.writeFloatLE(value),
+            fromBuffer: (buffer) => buffer.readFloatLE(0)
+        },
+        {
+            name: ['LREAL', 'DOUBLE'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_REAL64,
+            size: 8,
+            toBuffer: (value, buffer) => buffer.writeDoubleLE(value),
+            fromBuffer: (buffer) => buffer.readDoubleLE(0)
+        },
+        {
+            name: ['LWORD', 'ULINT', 'LTIME', 'UINT64'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_UINT64,
+            size: 8,
+            toBuffer: (value, buffer) => {
+                //64 bit integers are missing from older Node.js Buffer, so use buffer instead if so
+                if (typeof value === 'bigint' && buffer.writeBigUInt64LE) {
+                    buffer.writeBigUInt64LE(value);
+                }
+                else if (typeof value === 'number' && buffer.writeBigUInt64LE) {
+                    buffer.writeBigUInt64LE(BigInt(value));
+                }
+                else if (typeof value === 'object' && Buffer.isBuffer(value)) {
+                    value.copy(buffer);
+                }
+                else {
+                    throw new Error(`Could not convert ${value} to LWORD/ULINT/LTIME - BigInt is not supported`);
+                }
+            },
+            fromBuffer: (buffer) => {
+                if (buffer.readBigUInt64LE !== undefined) {
+                    return buffer.readBigUInt64LE(0);
+                }
+                else {
+                    return buffer;
+                }
+            }
+        },
+        {
+            name: ['LINT', 'INT64'],
+            adsDataType: exports.ADS_DATA_TYPES.ADST_INT64,
+            size: 8,
+            toBuffer: (value, buffer) => {
+                //64 bit integers are missing from older Node.js Buffer, so use buffer instead if so
+                if (typeof value === 'bigint' && buffer.writeBigInt64LE) {
+                    buffer.writeBigInt64LE(value);
+                }
+                else if (typeof value === 'number' && buffer.writeBigInt64LE) {
+                    buffer.writeBigInt64LE(BigInt(value));
+                }
+                else if (typeof value === 'object' && Buffer.isBuffer(value)) {
+                    value.copy(buffer);
+                }
+                else {
+                    throw new Error(`Could not convert ${value} to LINT - BigInt is not supported`);
+                }
+            },
+            fromBuffer: (buffer) => {
+                if (buffer.readBigInt64LE !== undefined) {
+                    return buffer.readBigInt64LE(0);
+                }
+                else {
+                    return buffer;
+                }
+            }
+        },
+    ],
+    /**
+     * Returns true if given data type is found and known
+     *
+     * @param {string} name Data type name
+     */
+    isPseudoType: function (name) {
+        return this.findPseudoType(name) !== undefined;
+    },
+    /**
+     * Finds the given pseudo data type from array using regular expressions
+     *
+     * @param {string} name Pseudo data type name
+     */
+    findPseudoType: function (name) {
+        return this.pseudoTypes.find(type => {
+            const regexName = type.name.map(t => `^${t}`);
+            const re = new RegExp(regexName.join('|'), 'i');
+            return re.test(name.trim());
+        });
+    },
+    /**
+     * Finds the given pseudo data type from array using regular expressions
+     *
+     * @param name Pseudo data type name (like PVOID)
+     */
+    getTypeByPseudoType: function (name, byteSize) {
+        return this.findPseudoType(name)?.actualTypesBySize[byteSize];
+    },
+    /**
+     * All pseudo data types and their actual types depending on size
+     * Example: XINT is 4 bytes @ 32 bit platform -> DINT
+     */
+    pseudoTypes: [
+        {
+            name: ['XINT', '__XINT'],
+            actualTypesBySize: {
+                4: 'DINT',
+                8: 'LINT'
+            }
+        },
+        {
+            name: ['UXINT', '__UXINT', 'POINTER TO', 'REFERENCE TO', 'PVOID'],
+            actualTypesBySize: {
+                4: 'UDINT',
+                8: 'ULINT'
+            }
+        },
+        {
+            name: ['XWORD', '__XWORD'],
+            actualTypesBySize: {
+                4: 'DWORD',
+                8: 'LWORD'
+            }
+        },
+    ]
+};
+/**
+ * Converts array of bytes (or Buffer) to AmsNetId string, such as 192.168.1.10.1.1
+ *
+ * @param byteArray Array of bytes or Buffer object
+ */
+const byteArrayToAmsNetIdStr = (byteArray) => {
+    return byteArray.join('.');
+};
+exports.byteArrayToAmsNetIdStr = byteArrayToAmsNetIdStr;
+/**
+ * Converts AmsNetId string (such as 192.168.10.1.1) to array of bytes
+ *
+ * @param str AmsNetId as string
+ */
+const amsNetIdStrToByteArray = (str) => {
+    return str.split('.').map(x => parseInt(x));
+};
+exports.amsNetIdStrToByteArray = amsNetIdStrToByteArray;
+/**
+ * Trims the given PLC string until end mark (\0) is found (removes empty bytes from the end)
+ *
+ * @param str String to trim
+ * @returns Trimmed string
+ */
+const trimPlcString = (str) => str.substring(0, str.indexOf("\0"));
+exports.trimPlcString = trimPlcString;
+/**
+ * Decodes provided Buffer object to plc STRING using cp1252 encoding.
+ * Also removes empty bytes from the end.
+ * @param data Buffer data that contains plc STRING
+ * @returns
+ */
+const decodePlcStringBuffer = (data) => (0, exports.trimPlcString)(iconv_lite_1.default.decode(data, "cp1252"));
+exports.decodePlcStringBuffer = decodePlcStringBuffer;
+/**
+ * Encodes provided string to a Buffer object as plc STRING using cp1252 encoding
+ * @param str String to encode
+ * @returns
+ */
+const encodeStringToPlcStringBuffer = (str) => iconv_lite_1.default.encode(str, "cp1252");
+exports.encodeStringToPlcStringBuffer = encodeStringToPlcStringBuffer;
+/**
+ * Decodes provided Buffer object to plc WSTRING using ucs2 encoding.
+ * Also removes empty bytes from the end.
+ * @param data Buffer data that contains plc WSTRING
+ * @returns
+ */
+const decodePlcWstringBuffer = (data) => (0, exports.trimPlcString)(iconv_lite_1.default.decode(data, "ucs2"));
+exports.decodePlcWstringBuffer = decodePlcWstringBuffer;
+/**
+ * Encodes provided string to a Buffer object as plc WSTRING using ucs2 encoding
+ * @param str String to encode
+ * @returns
+ */
+const encodeStringToPlcWstringBuffer = (str) => iconv_lite_1.default.encode(str, "ucs2");
+exports.encodeStringToPlcWstringBuffer = encodeStringToPlcWstringBuffer;
+/**
+ * Converts given AmsAddress as string of type `amsNetId:port`
+ * @param address
+ * @returns
+ */
+const amsAddressToString = (address) => `${address.amsNetId}:${address.adsPort}`;
+exports.amsAddressToString = amsAddressToString;
+//# sourceMappingURL=ads-commons.js.map