ElectronicLabel

一个用于控制和管理 ST203 电子标签的 Node.js 包。提供了对 ST203 电子标签的基本操作，例如亮灯、灯光闪烁、数显、监听按钮事件等功能。

目录

• 安装
• 使用
  • 初始化 ST203 控制器
  • 亮灯
  • 设置灯光颜色
  • 关闭灯光
  • 使灯光闪烁
  • 停止灯光闪烁
  • 显示数字
  • 清除显示
  • 停止所有 LED 数字显示闪烁
  • 监听按钮事件
  • 读取所有标签信息
  • 关闭连接
• 广播地址
• 贡献
• 许可证

安装

使用 npm 安装：

npm install hc-electronic-label-controller 

使用

初始化 ST203 控制器

import { ST203Controller } from 'hc-electronic-label-controller';

const HOST = '192.168.1.100';
const PORT = 4660;
const OPTIONS = {
  retryDelay: 5000, // 可选：socket初始重试间隔时间，默认值为 5s
  maxRetryDelay: 60000, // 可选：socket断连最大重试间隔时间，默认值为 1mins
  sendInterval: 100 // 可选：发送消息的时间间隔，默认值为0ms
  heartbeatInterval: 1000 * 120 // 可选：发送心跳的时间间隔，默认值为2 mins； 参数传0时关闭心跳
};

const controller = new ST203Controller(HOST, PORT, OPTIONS);

controller.connect().then(() => {
  console.log('Connected to ST203 controller');
}).catch((err) => {
  console.error('Failed to connect:', err);
});

亮灯

// 使指定地址的灯亮起
controller.turnOnLight(0x01).then(() => {
  console.log('Light turned on');
}).catch((err) => {
  console.error('Failed to turn on light:', err);
});

设置灯光颜色

// 设置指定地址的灯的颜色
controller.setColor(0x01, 'green').then(() => {
  console.log('Color set to green');
}).catch((err) => {
  console.error('Failed to set color:', err);
});

关闭灯光

// 关闭指定地址的灯
controller.turnOffLight(0x01).then(() => {
  console.log('Light turned off');
}).catch((err) => {
  console.error('Failed to turn off light:', err);
});

使灯光闪烁

// 使指定地址的灯闪烁
controller.blinkLight(0x01).then(() => {
  console.log('Light is blinking');
}).catch((err) => {
  console.error('Failed to blink light:', err);
});

停止灯光闪烁

// 停止指定地址的灯闪烁
controller.stopBlinkLight(0x01).then(() => {
  console.log('Stopped blinking light');
}).catch((err) => {
  console.error('Failed to stop blinking light:', err);
});

显示数字

// 在指定地址显示数字
controller.displayNumber(0x01, 123).then(() => {
  console.log('Number displayed');
}).catch((err) => {
  console.error('Failed to display number:', err);
});

清除显示

// 清除指定地址的显示
controller.clearDisplay(0x01).then(() => {
  console.log('Display cleared');
}).catch((err) => {
  console.error('Failed to clear display:', err);
});

停止所有 LED 数字显示闪烁

// 停止指定地址所有 LED 数字显示的闪烁
controller.stopAllNumBlinking(0x01).then(() => {
  console.log('Stopped all number blinking');
}).catch((err) => {
  console.error('Failed to stop all number blinking:', err);
});

监听按钮事件

// 在您的 ST203Controller 类中
import { utils } from 'hc-electronic-label-controller';

// 初始化 currentNumbers 变量用于存储每个地址的当前数值
let currentNumbers = {};

  controller.on('buttonPress', async (address, buttonCode, data) => {
    console.log(`Button pressed on address ${address} with code ${buttonCode}`);
  
    switch (buttonCode) {
      case 0x06: {
        const digits = data.slice(11, 14).map(digit => digit - 0x30);
        const confirmNumber = utils.digitsToNumber(digits);
        console.log(`Confirm Button pressed on tag ${address}, number: ${confirmNumber}`);
        break;
      }
      case 0x64: {
        // 子命令为0x64时，数据位1为43H “shortage button/down-count button” pressed, 为25H “function button/up-count button” pressed。
        const dataField1 = data[9];
        console.log(`Number Button pressed on tag ${address}: Data field 1 0x${dataField1.toString(16)}`);
        switch (dataField1) {
          case 0x25:
            currentNumbers[address] = utils.incrementNumber(currentNumbers[address]);
            await controller.displayNumber(address, currentNumbers[address]);
            break;
          case 0x43:
            currentNumbers[address] = utils.decrementNumber(currentNumbers[address]);
            await controller.displayNumber(address, currentNumbers[address]);
            break;
        }
        break;
      }
      default:
        console.log(`Button pressed on tag ${address}: Unknown button code ${buttonCode}`);
    }
  });

读取所有标签信息

// ！未测试，不推荐使用
// 读取控制器下所有标签的信息
controller.readAllTagInfo().then(() => {
  console.log('Reading all tag info');
}).catch((err) => {
  console.error('Failed to read tag info:', err);
});

controller.on('tagsInfo', (tags) => {
  console.log('Tags Info:', tags);
});

关闭连接

// 关闭控制器的连接
controller.close();

广播地址, 心跳包

广播地址用于发送命令到所有连接的标签设备。通常广播地址为 0xFC。

例如：

controller.turnOnLight(0xFC).then(() => {
  console.log('All lights turned on');
}).catch((err) => {
  console.error('Failed to turn on all lights:', err);
});

贡献

如果你有任何改进或建议，欢迎提交 pull request 或 issue。

许可证

MIT