HTML一键打包EXE串口API介绍

发布于:2025-06-23 ⋅ 阅读:(21) ⋅ 点赞:(0)

HTML一键打包EXE软件(HTML转EXE) 支持将Web前端项目转换为Windows平台下的独立可执行程序(EXE),适用于Windows 7及以上系统,无需额外配置系统环境, 软件包含多种内核, 包括IE内核, Chrome内核, 以及WebView2(永久免费), 适用于不同的使用场景. 

CSDN免积分下载地址:

【免费】HTML转EXE最新2.1.0版本(包含免费内核)-解压密码1234资源-CSDN文库

本文主要对串口API进行介绍, 详细说明如何使用HTML一键打包EXE文件支持串口连接等功能. 如果你想了解其他关于HTML打包EXE功能, 可以参考我们之前的文章:

WebView2与Chrome内核的区别和使用场景详细介绍-CSDN博客

HTML打包EXE中Webview2内核介绍和使用说明_webview2使用教程-CSDN博客

HTML(网页)打包EXE, 添加网络验证(卡密)详解_html打包exe-CSDN博客

首先简单介绍下串口, 首先串口(Serial Port)是一种非常经典的数据通信接口。它的核心特点是一位一位地顺序传输数据(串行传输),这与同时传输多位数据的并行接口不同。虽然速度通常不快,但串口以其简单、可靠、成本低的优势,在特定领域一直扮演着重要角色。

最常见的串口类型是异步串口(比如电脑上曾经的COM口)。它不需要专门的时钟线,通信双方依靠事先约定好的速度(波特率)和数据格式(如起始位、停止位)来同步数据。RS-232是早期最普及的标准,而RS-485则因其使用差分信号,抗干扰能力强、传输距离远(可达上千米),成为工业环境中的主力。

串口在我们日常生活中最常见的使用常见便是一些刷卡设备, 通常使用串口连接计算机进行通信, 可以方便的进行用户认证等场景.

HTML转EXE内部支持了串口API, 如果需要使用, 可以在打包时勾选上 启用API

勾选后, 打包的网页即可以使用串口相关的API了, 下面是一个完整的串口通信的HTML的例子, 它可以进行串口连接, 发送数据:

<html>

<head>
    <script>
        const SerialPort = HTMLPackHelper.getSerialPort().SerialPort;
        let port;
        let isOpened;
        async function showPorts() {
            let ports = await SerialPort.list();
            document.getElementById("textArea").value += ports.map(port => port.path + ":" + port.friendlyName).join("\n") + "\n";
        }
        async function openPort() {
            const portName = document.getElementById("portName").value;
            port = new SerialPort({ path: portName, baudRate: 9600, autoOpen: false });
            if (port.isOpened) {
                try {
                    await port.close()
                }
                catch (err) {
                    document.getElementById("textArea").value += '端口关闭失败!' + err.message + "\n";
                    return;
                }
            }

            port.on('error', err => {
                document.getElementById("textArea").value += '发生错误: ' + err.message + "\n";
            });

            port.on('data', data => {
                document.getElementById("textArea").value += '收到数据: ' + data + "\n";
            });

            port.open(function (err) {
                if (err) {
                    document.getElementById("textArea").value += '端口打开失败: ' + err.message + "\n";
                    return;
                }
                isOpened = true;
                document.getElementById("textArea").value += '打开端口成功' + "\n";
            });


        }
        async function sendData() {
            const data = document.getElementById("data").value;
            try {
                port.write(data + "\n");
                document.getElementById("textArea").value += '发送数据成功\n';
            }
            catch (err) {
                document.getElementById("textArea").value += '发送数据失败: ' + err.message+'\n';
            }
        }
    </script>
</head>

<body>
    <button onclick="showPorts()">显示所有串口信息</button>
    <div>
        <textarea id="textArea" style="width: 800px;height: 600px;"></textarea>
    </div>
    <br>
    <button onclick="openPort()">连接串口</button>
    <label>串口名称</label>
    <input id="portName" type="text"></input>
    <button onclick="sendData()">发送数据</button>
    <input id="data" type="text"></input>
</body>
</html>

把上面的文件保存到一个单独的文件夹中, 然后用HTML一键打包EXE工具进行打包, 打包生成的EXE文件如下:

此时, 我们可以在打包生成的EXE中, 先点击显示所有串口信息, 即可列出当前系统中的所有串口名称, 此时我们在打包生成EXE的下方, 输入串口名称(例如COM4), 然后点击连接串口, 即可对窗口进行连接, 此时我们便可以发送数据了.

API详解

打包的时候勾选启用API, 即可在HTML页面的任意位置调用串口通信API,进行串口通信。示例代码如下:

const SerialPort = HTMLPackHelper.getSerialPort().SerialPort;

获得串口列表代码:

const ports = await SerialPort.list();
console.log(ports.map(port => port.path + ":" + port.friendlyName).join("\n"));

上面的代码可以打印出类似如下的串口信息

COM1:Electronic Team Virtual Serial Port (COM1->COM2)
COM2:Electronic Team Virtual Serial Port (COM2->COM1)

打开COM1串口,并添加监听事件,用于接收串口发到上位机的数据

const port = new SerialPort({ path: "COM1", baudRate: 9600, autoOpen: false });

port.on('error', err => {
  console.log('发生错误: ' + err.message + "\n");
});

port.on('data', data => {
  console.log('收到数据: ' + data + "\n");
});

port.open(function (err) {
  if (err) {
    console.log('端口打开失败: ' + err.message + "\n");return;
  }
  console.log('打开端口成功' + "\n");
}); 

向COM1串口发送数据

try {
  port.write("你好"+ "\n");
}
catch (err) {
  console.log('发送数据失败: ' + err.message+'\n');
}


 


网站公告

今日签到

点亮在社区的每一天
去签到