Fsuipc.js NPM | npm.io

FSUIPC client implementation for NodeJS.

fsuipc.js

This package allows you to use the single-minimal version of fsuipc.js.

Read our contribution guidelines.

Quick start

Install fsuipc.js:

yarn add fsuipc.js

Import the module and create a new object:

const fsuipcModule = require('fsuipc.js');

const simulator = new fsuipcModule.FSUIPC();

3: Use the method open to request a offset and then, read the value in the promise:

simulator
  .open()
  .then((request) => {
    /* Offset name, value in hexadecimal and data type. */
    request.add('clockHour', 0x238, fsuipcModule.Type.Byte);

    return request.process();
  })
  .then((result) => {
    console.log(JSON.stringify(result));

    return simulator.close();
  })
  .catch((err) => {
    console.error(err);

    return simulator.close();
  });

Methods:

Open:

Opens a connection with a running FSUIPC stream:

simulator.open(requestedSimulator?: Simulator);

open method takes 1 optional argument:

requestedSimulatorSimulator: simulator identifier in number, you can get the simulator ident or type importing:

import { Simulator } from 'fsuipc.js';

console.log(Simulator.MSFS);

When requestedSimulator is not present, the module tries to open a connection with any FSUIPC stream open.

Close:

Closes a running connection:

simulator.close();

Process:

Process a offset request:

request.add('clockHour', 0x238, fsuipcModule.Type.Byte);

simulator.process();

Add:

Adds a offset request to a FSUIPC stream:

request.add('clockHour', 0x238, fsuipcModule.Type.Byte);

Add method takes 3-4 arguments:

namestring: offset identifier in string.
offsetnumber: a hexadecimal number that corresponds to a FSUIPC offset.
typeFixedSizedNumberType | FixedSizedStringType | VariableSizedType: a type that corresponds to a type of data.
lengthnumber: a number that corresponds to data length.

Write (experimental):

Writes a value into the simulator.

request.write(0x3590, fsuipcModule.Type.Int32, 4, 0); // Closes the engine 1 fuel valve.

Writes method takes 3-4 arguments:

offsetnumber: a hexadecimal number that corresponds to a FSUIPC offset.
typeFixedSizedNumberType | FixedSizedStringType | VariableSizedType: a type that corresponds to a type of data.
lengthnumber: a number that corresponds to data length.
valuestring | ArrayBufferView: a value that corresponds to the data that we are sending.