HTD Lync12 Library

This library is meant to be used to interact with an HTD Lync 12

Installation

npm install htd-lync-js

Lync Serial Hex Codes Documentation

https://www.htd.com/site/ownersmanual/lync_hex_codes.pdf

Useful Commands

Run Converter

pnpm dlx vite-node dev/reference_hex_to_dec.ts reference/hex_codes/by_function.txt reference/decimal/by_function.txt
pnpm dlx vite-node dev/reference_hex_to_dec.ts reference/hex_codes/by_name.txt reference/decimal/by_name.txt
pnpm dlx vite-node dev/reference_hex_to_dec.ts reference/hex_codes/by_zone.txt reference/decimal/by_zone.txt
pnpm dlx vite-node dev/reference_hex_to_dec.ts reference/hex_codes/by_code.txt reference/decimal/by_decimal.txt

# Paste the output of this into the resulting file
cat reference/decimal/by_decimal.txt | sort --version-sort

Dev Tests

This is just a file I use to test against my own system.

pnpm dlx vite-node dev/status.ts

Usage / Dev Notes

It seems in order for some commands to take, you need to set the source afte the command. For instance, if you want to update the volume, bass, treble, etc, those settings won't take unless you also update the source.

For this, it's a good idea to keep track of the source of a zone, so that you can re-set it to the same source.

In the following example, none of these "set_[property]" commands will take, until you call set_source. At that point, you'll get a response from the Controller with the updated settings.

const zone = Zone._01;
const source = Source._01;

await LC.send_command(Command.set_volume(zone, 25));
await LC.send_command(Command.set_bass(zone, 2));
await LC.send_command(Command.set_treble(zone, 2));
await LC.send_command(Command.set_balance(zone, 0));
await LC.send_command(Command.set_source(zone, source));

MP3 Repeat

As far as I can tell, the only way to figure out if the MP3 player is set to repeat is to get a zone status. There is no event given by the server that the repeat status has changed.

I'm wondering if it might even make sense to power a zone off and on when changing the repeat status, just to ensure the server sends an update to all clients. Probably best to just communicate between the clients at that point.

MP3 Play Status

I cannot yet find a way to determine whether an MP3 is playing upon load. If You Play or FF or Rewind, then the clients get a notification of the new filename and artist, but there's nothing apparent for grabbing the mp3 player's current player status

There's also no message sent out to clients when the MP3 is stopped. But once stopped, if I send a Play command, the file and artist are returned

I have no idea when the MP3 End, MP3 On and MP3 Off events occur. I have not been able to trigger them.

Echo Mode

I haven't tested "echo mode" thoroughly, but I have found that if it's off, then MP3 new track events are emitted but if I cycle the power of a zone, no events are emitted.

TODO: IsVolume Bit

According to the documentation, if you are changing the volume, the second bit in a command should be 0x01, but in my tests, setting it to 0x00 like all other commands works just fine. There's no discernable difference between setting the second bit to 0x00 or 0x01 for setting volume, or any other command, really