HiQnet

Parsing library for HiQnet communication protocol

Installation

npm install hiqnet

Version History

Version	Release Notes
0.0.5	Fixed: github actions not publishing .js and .d.ts
0.0.4	Package publishing automation
0.0.3	Fixed missing .js and .d.ts files
0.0.2	Fixed broken links in readme
0.0.1	Initial beta release

Usage

Sending Commands

Before sending a command to a Blu device, use hiqnet.encapsulatCommand(buf: Buffer). This function will byte substitute, add checksum, and prepend/append STX/ETX respectively.

const hiqnet = require('hiqnet');

let cmd_id = Buffer.from([0x88]);
let address = Buffer.from([0x00, 0x09, 0x03, 0x00, 0x01, 0x00, 0x4e, 0x20]);
let data = hiqnet.encDiscrete(10);

let cmd = hiqnet.encapsulateCommand(Buffer.concat([cmd_id, address, data]));

// send encapsulated command to Blu device via TCP or Serial.

There are several functions to facilitate encoding data types:

• encDiscrete(v: number): Buffer
• encPercent(v: number): Buffer
• encGain(v: number): Buffer
• encScalarLinear(v: number): Buffer
• encDelay(v: number): Buffer
• encFrequencyOrSpeed(v: number)

Parsing Responses

To parse incomming messages, use hiqnet.decapsulateCommand(buf: Buffer). This function will strip STX/ETX, verify and remove checksum, and byte unsubstitute.

const hiqnet = require('hiqnet');

let cmd = hiqnet.decapsulateCommand(rx$);

let cmd_id = hiqnet.getCommandIdBuffer(cmd);
let address = hiqnet.getAddressBuffer(cmd);
let data = hiqnet.getDateBuffer(cmd);

// decode data buffer
let dataValue = hiqnet.decDiscrete(data);

There are several functions to facilitate decoding data types:

• decDiscrete(b: Buffer): number
• decPercent(b: Buffer): number
• decGain(b: Buffer): number
• decScalarLinear(b: Buffer): number
• decDelay(b: Buffer): number
• decFrequencyOrSpeed(b: Buffer): number

Resources

• Soundweb London DI Kit
• Soundweb London 3rd Party Control

Address Property

The address property is a buffer of exactly 8 bytes. it is comprised of:

• Node Address (2 bytes)
• Virtual Device (1 byte)
• Object ID (3 bytes)
• Parameter ID (2 bytes)

The following bytes have special meanings. The node suite will automatically handle replacement when commands are encapsulated and decapsulated. Be mindfull on nodes requiring an address property that the non replaced character is needed in decimal format.

TYPE	HEX	HEX replacement	DEC	DEC replacement
STX	0x02	0x1B, 0x82	2	27, 130
ETX	0x03	0x1B, 0x83	3	27, 131
ACK	0x06	0x1B, 0x86	6	27, 134
NAK	0x15	0x1B, 0x95	21	27, 149
Escape	0x1B	0x1B, 0x9B	27	27, 155

Feature Requests / Bug Reporting

Please report any bugs or issues to the repository here.