enip-ts
Version:
Typescript implementation of the Ethernet/IP™ protocol.
183 lines • 8.34 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
exports.ConnectionManager = exports.FixedVar = exports.Priority = exports.ConnectionType = exports.Owner = void 0;
/** lookup for the Redundant Owner (Vol.1 - Table 3-5.8 Field 15) */
var Owner;
(function (Owner) {
Owner[Owner["Exclusive"] = 0] = "Exclusive";
Owner[Owner["Multiple"] = 1] = "Multiple";
})(Owner || (exports.Owner = Owner = {}));
;
/** lookup for the Connection Type (Vol.1 - Table 3-5.8 Field 14,13) */
var ConnectionType;
(function (ConnectionType) {
ConnectionType[ConnectionType["Null"] = 0] = "Null";
ConnectionType[ConnectionType["Multicast"] = 1] = "Multicast";
ConnectionType[ConnectionType["PointToPoint"] = 2] = "PointToPoint";
ConnectionType[ConnectionType["Reserved"] = 3] = "Reserved";
})(ConnectionType || (exports.ConnectionType = ConnectionType = {}));
;
/** lookup for the Connection Priority (Vol.1 - Table 3-5.8 Field 11,10) */
var Priority;
(function (Priority) {
Priority[Priority["Low"] = 0] = "Low";
Priority[Priority["High"] = 1] = "High";
Priority[Priority["Scheduled"] = 2] = "Scheduled";
Priority[Priority["Urgent"] = 3] = "Urgent";
})(Priority || (exports.Priority = Priority = {}));
;
/** lookup for the fixed or variable parameter (Vol.1 - Table 3-5.8 Field 9) */
var FixedVar;
(function (FixedVar) {
FixedVar[FixedVar["Fixed"] = 0] = "Fixed";
FixedVar[FixedVar["Variable"] = 1] = "Variable";
})(FixedVar || (exports.FixedVar = FixedVar = {}));
;
/** lookup table for Time Tick Value (Vol.1 - Table 3-5.11) @warn not used for now */
const timePerTick = {
1: 0
};
const connSerial = 0x1337;
/**
* lookup table for Timeout multiplier (Vol.1 - 3-5.4.1.4)
*/
const timeOutMultiplier = {
4: 0,
8: 1,
16: 2,
32: 3,
64: 4,
128: 5,
256: 6,
512: 7
};
function getRandomInt(max) {
return Math.floor(Math.random() * Math.floor(max));
}
/** Connection manager with static props to manage connection */
class ConnectionManager {
/**
* Build for Object specific connection parameters (Vol.1 - Table 3-5.8)
*/
static build_connectionParameters(owner, type, priority, fixedVar, size) {
if (owner != 0 && owner != 1)
throw new Error("Owner can only be exclusive (0) or multiple (1)");
if (type > 3 || type < 0)
throw new Error("Type can only be Null(0), Multicast(1), PointToPoint(2) or Reserved(3)");
if (priority > 3 || priority < 0)
throw new Error("Priority can only be Low(0), High(1), Scheduled(2) or Urgent(3)");
if (fixedVar != 0 && fixedVar != 1)
throw new Error("Fixedvar can only be Fixed(0) or VariableI(1)");
if (size > 10000 || size <= 1 || typeof size !== "number")
throw new Error("Size must be a positive number between 1 and 10000");
return owner << 15 | type << 13 | priority << 10 | fixedVar << 9 | size;
}
;
/**
* Gets the Best Available Timeout Values
* @param timeout - Desired Timeout in ms
* @returns Encoded Timeout Values
*/
static generateEncodedTimeout(timeout) {
if (timeout <= 0 || typeof timeout !== "number")
throw new Error("Timeouts Must be Positive Integers");
let diff = Infinity; // let difference be very large
let time_tick = 0;
let ticks = 0;
// Search for Best Timeout Encoding Values
for (let i = 0; i < 16; i++) {
for (let j = 1; j < 256; j++) {
const newDiff = Math.abs(timeout - Math.pow(2, i) * j);
if (newDiff <= diff) {
diff = newDiff;
time_tick = i;
ticks = j;
}
}
}
return { time_tick, ticks };
}
;
/**
* Builds the data portion of a forwardOpen packet
*
* @param [timeOutMs=500] - How many ticks until a timeout is thrown
* @param [timeOutMult=32] - A multiplier used for the Timeout
* @param [otRPI=8000] - O->T Request packet interval in milliseconds.
* @param [serialOrig=0x1337] - Originator Serial Number (SerNo of the PLC)
* @returns data portion of the forwardOpen packet
*/
static build_forwardOpen(otRPI = 8000, netConnParams = 0x43f4, timeOutMs = 1000, timeOutMult = 32, connectionSerial = 0x4242) {
if (timeOutMs <= 900 || typeof timeOutMs !== "number")
throw new Error("Timeouts Must be Positive Integers and above 500");
if (!(timeOutMult in timeOutMultiplier) || typeof timeOutMult !== "number")
throw new Error("Timeout Multiplier must be a number and a multiple of 4");
if (otRPI < 8000 || typeof otRPI !== "number")
throw new Error("otRPI should be at least 8000 (8ms)");
if (typeof netConnParams !== "number")
throw new Error("ConnectionParams should be created by the builder and result in a number!");
const actualMultiplier = timeOutMultiplier[timeOutMult];
const connectionParams = Buffer.alloc(35); // Normal forward open request
const timeout = this.generateEncodedTimeout(timeOutMs);
let ptr = 0;
connectionParams.writeUInt8(timeout.time_tick, ptr); // Priority / TimePerTick
ptr += 1;
connectionParams.writeUInt8(timeout.ticks, ptr); // Timeout Ticks
ptr += 1;
connectionParams.writeUInt32LE(0, ptr); // O->T Connection ID
ptr += 4;
connectionParams.writeUInt32LE(getRandomInt(2147483647), ptr); // T->O Connection ID
ptr += 4;
connectionParams.writeUInt16LE(connectionSerial, ptr); // Connection Serial Number TODO: Make this unique
ptr += 2;
connectionParams.writeUInt16LE(0x3333, ptr); // Originator VendorID
ptr += 2;
connectionParams.writeUInt32LE(0x1337, ptr); // Originator Serial Number
ptr += 4;
connectionParams.writeUInt32LE(actualMultiplier, ptr); // TimeOut Multiplier
ptr += 4;
connectionParams.writeUInt32LE(otRPI, ptr); // O->T RPI
ptr += 4;
connectionParams.writeUInt16LE(netConnParams, ptr); // O->T Network Connection Params
ptr += 2;
connectionParams.writeUInt32LE(otRPI, ptr); // T->O RPI
ptr += 4;
connectionParams.writeUInt16LE(netConnParams, ptr); // T->O Network Connection Params
ptr += 2;
connectionParams.writeUInt8(0xA3, ptr); // TransportClass_Trigger (Vol.1 - 3-4.4.3) -> Target is a Server, Application object of Transport Class 3.
return connectionParams;
}
;
/**
* Builds the data portion of a forwardClose packet
*
* @param {number} [timeOutMs=501] - How many ms until a timeout is thrown
* @param {number} [vendorOrig=0x3333] - Originator vendorID (Vendor of the PLC)
* @param {number} [serialOrig=0x1337] - Originator Serial Number (SerNo of the PLC)
* @returns {Buffer} data portion of the forwardClose packet
*/
static build_forwardClose(timeOutMs = 1000, vendorOrig = 0x3333, serialOrig = 0x1337, connectionSerial = 0x4242) {
if (timeOutMs <= 900 || typeof timeOutMs !== "number")
throw new Error("Timeouts Must be Positive Integers and at least 500");
if (vendorOrig <= 0 || typeof vendorOrig !== "number")
throw new Error("VendorOrig Must be Positive Integers");
if (serialOrig <= 0 || typeof serialOrig !== "number")
throw new Error("SerialOrig Must be Positive Integers");
const connectionParams = Buffer.alloc(10);
const timeout = this.generateEncodedTimeout(timeOutMs);
let ptr = 0;
connectionParams.writeUInt8(timeout.time_tick, ptr); // Priority / TimePerTick
ptr += 1;
connectionParams.writeUInt8(timeout.ticks, ptr); // Timeout Ticks
ptr += 1;
connectionParams.writeUInt16LE(connectionSerial, ptr); // Connection Serial Number TODO: Make this unique
ptr += 2;
connectionParams.writeUInt16LE(vendorOrig, ptr); // Originator VendorID
ptr += 2;
connectionParams.writeUInt32LE(serialOrig, ptr); // Originator Serial Number
return connectionParams;
}
;
}
exports.ConnectionManager = ConnectionManager;
//# sourceMappingURL=connectionManager.js.map